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本 书 以 Spring 应 用 程序 开发 为 中 心 ， 全 面 讲 
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F 解 如 何 运 用 Spring Boot 提高 效率 ， 使 应 用 程序 的 开发 和 管 




















理 更 加 轻松 有 趣 。 作 者 行文 亲切 流畅 , 以 大 量 示 例 讲 解 了 Spring Boot 在 各 类 情境 中 的 应 用 , 内 容 涵盖 起 步 依 赖 、 
发 应 用 中 较为 繁琐 的 内 容 ， 附 录 奉 上 整理 完 





Spring Boot CLI、 Groovy、 Grails、Actuator。 
上 毕 的 表格 ， 一目了然 ， 方 便 读者 查阅 。 
本 书 适合 全 体 Java 开发 人 员 。 
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译 者 序 


时 光 回 到 2004 年 , Spring Framework 1.0 正 式 发 布 , 同年 , Rod Johnson 的 Expert one-on-one J2EE 
Development without EJB 一 经 出 版 就 震撼 了 整个 Java 世 界 。 不 知 不 觉 ，12 年 就 这 么 过 去 了 ，Spring 
已 然 成 为 Java 应 用 开发 的 事实 标准 ， 影 响 着 无 数 Java 开 发 者 。 

刚才 打开 Spring 的 官网 ， 已 经 能 看 到 Spring Framework 5.0.0 SNAPSHOT 的 身影 了 ， 而 Spring 
的 家 族 也 早 就 不 再 是 Spring Framework 一 枝 独 秀 ，Spring Data, Spring Batch, Spring Security 等 一 
大 堆 名 字 让 人 看 得 眼花 练 乱 。 其 中 最 引 人 瞩 目的 无 疑 就 是 Spring Boot 了 ， 它 正 是 本 书 的 主角 。 

Spring Boot 从 无 数 知名 企业 的 实践 中 吸取 经 验 ， 总 结 并 落实 到 框架 中 。 如 果 说 Spring 
Framework 的 目标 是 帮助 开发 者 写 出 好 的 系统 ， 那 Spring Boot 的 目标 就 是 帮助 开发 者 用 更 少 的 代 
码 ， 更 快 地 写 出 好 的 生产 系统 。 

Spring Boot 为 开发 者 带 来 了 更 好 的 开发 体验 , 但 写 完 代码 只 是 万 里 长 征 路 上 的 一 小 步 , 后 续 的 
运 维 工作 才 是 让 很 多 人 真正 感到 无 助 的 。Spring Boot 在 运 维 方 面 做 了 很 多 工作 , 部 署 、 监 控 、 度 量 ， 
无 一 不 在 其 涉 狂 范围 之 内 ， 结 合 Spring Cloud 后 还 可 以 轻松 地 实现 服务 发 现 、 服 务 降级 等 功能 。 

2014 年 ，Spring Source 的 Josh Long 在 向 我 介绍 Spring Boot 时 ， 我 不 断 重复 一 句 话 :“ 这 个 功 
能 我 们 也 做 了 。” 的 确 ， 国 内 的 百度 、 阿 里 、 腾 讯 ， 国 外 的 Amazon、Facebook、Twitter、Netflix 
等 一 票 大 公司 都 在 框架 和 系统 建设 上 有 大 量 投入 , 为 了 提升 性 能 和 可 用 性 , 大 家 做 了 很 多 卓 有 成 
效 的 工作 。 现 在 ，Spring Boot 让 人 人 都 能 享受 业内 顶级 公司 的 “福利 ”， 站 在 巨人 的 肩膀 之 上 ， 
想 想 都 让 人 觉得 兴奋 。 

说 起 为 何 想 要 翻译 本 书 ， 那 只 能 说 是 缘分 使 然 。 笔 者 当年 在 机 缘 巧合 之 下 与 Spring 结缘 ， 也 
因 它 结识 了 很 多 朋友 。 训 不 夸张 地 说 ， 是 Spring 开启 了 我 的 作 译 者 生涯 ， 先 后 参与 了 Spring 官方 
文档 《Spring 专业 开发 指南 》 和 《Spring 攻略 》 的 翻译 。 

本 以 为 在 完成 了 30 岁 前 每 年 翻译 一 本 书 的 目标 后 , 我 应 该 不 会 再 去 翻译 什么 东西 了 , 甚至 在 
向 图 灵 的 编辑 推荐 本 书 时 , 我 都 没有 想到 最 后 会 是 自己 来 翻译 这 本 书 。 不 得 不 感叹 一 声 , 缘分 就 
是 如 此 妙 不 可 言 的 东西 。 相信 后 续 Spring Boot 会 有 更 好 地 发 展 , 因为 它 牢 牢 抓 位 了 开发 者 的 需求 。 
Craig 的 《Spring 实 战 》 已 经 到 了 第 4 版 ， 本 书 应 该 也 会 有 第 2 版 ， 此 时 此 刻 正 捧 着 本 书 的 您 会 成 为 
它 的 译 者 吗 ? 至 少 让 我 们 一 起 来 为 自己 喜欢 的 技术 贡献 一 份 力量 吧 。 
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2014 年 春天 , Netflix 的 交付 工程 团队 开始 着 手 实现 一 个 伟大 的 目标 一 一 通过 一 个 软件 平台 来 
实现 端 到 端的 全 局 持续 交付 ， 该 平台 有 利于 系统 的 可 扩展 性 及 弹性 。 为 了 满足 Netflix 的 交付 与 部 
署 需要 ,我 的 团队 曾 构建 了 两 套 不 同 的 应 用 程序 ,但 这 两 套 应 用 程序 都 有 演变 成 庞然大物 的 趋势 ， 
而 且 都 没 能 满足 灵活 性 和 弹性 的 目标 。 更 重要 的 是 , 这 些 庞大 的 应 用 程序 最 终 还 拖 了 我 们 的 后 腿 ， 
让 我 们 跟 不 上 合作 伙伴 的 创新 步伐 。 用 户 开始 回避 我 们 的 工具 ， 而 不 是 使 用 它们 。 

很 明显 ， 如果 想 要 癌 公 司 证 明 自 己 的 真正 价值 并 快速 创新 , 我 们 需要 把 庞然大物 分 解 成 小 的 
独立 服务 , 这 些 服 务 要 能 随时 发 布 。 拥 抱 微服 务 架构 给 我 们 带 来 了 希望 ， 让 我 们 能 实现 灵活 性 与 
弹性 的 双重 目标 。 但 是 我 们 需要 在 一 个 可 靠 的 基础 上 实现 这 一 架构 , 它 要 能 实现 真正 的 并 发 、 合 
理 的 监控 、 可 靠 易 用 的 服务 发 现 ， 运 行 时 还 要 有 极 好 的 性 能 。 

我 们 要 在 JVM 上 寻找 一 款 框架 , 它 要 直接 提供 快速 开发 的 能 力 和 强大 的 运 维 能 力 。 最终, R 
们 找到 了 Spring Boot。 

Spring Boot 能 用 寥寥 数 行 代 码 构 建 一 套 基 于 Spring 并 满足 生产 要 求 的 服务 ， 不 费 吹 灰 之 力 ! 
实际 上 , 一 个 简单 的 Spring Boot Hello World 应 用 程序 能 放 进 一 条 推 文 里 , 这 在 短 短 几 年 之 前 还 是 
完全 不 可 能 的 事情 。 它 还 自 带 了 不 少 非 功能 性 的 特性 ， 比 如 安全 、 上 度量、 健康 检查 、 内 山 服务 器 
和 外 置 配置 ， 这 些 都 让 选择 Spring Boot 成 为 了 一 件 顺理成章 的 事情 。 

然而 ， 踏 上 Spring Boot 之 旅 后 ,我 们 却 发 现 手 头 没有 好 的 文档 。 要 搞 明 白 怎 么 利用 好 框架 的 
特性 ， 只 能 依靠 源码 ， 这 可 不 是 个 让 人 愉快 的 办 法 。 

Manning 那 本 著名 的 《Spring 实战 》 的 作者 再 度 接受 挑战 , 将 Spring Boot 的 核心 用 法 写成 了 另 
一 本 好 书 , 对 此 我 一 点 都 不 吃惊 。 毫 无 疑问 , Craig 和 Manning 的 团队 又 做 成 了 一 件 了 不 起 的 大 事 ! 
正如 我 们 所 料 ,《 Spring Boot 实 战 》 是 一 本 通俗 易 懂 的 好 书 。 

从 第 1 章 引 人 入 胜 的 介绍 以 及 富有 传奇 色彩 的 90 字 符 推 文 应 用 程序 ， 一 直到 第 7 章 对 Spring 
Boot 的 Actuator ( 提供 了 很 多 生产 应 用 程序 所 需 的 神奇 的 运 维特 性 ) 的 深度 分 析 ,《Spring Boot 实 
战 》 做 到 了 知 无 不 言 ， 言 无 不 尽 。 实 际 上 ， 对 我 而 言 ,第 7 章 对 Actuator 的 深度 分 析 解 答 了 不 少 问 
题 ， 这 些 问题 自 一 年 多 以 前 我 开始 使 用 Spring Boot 后 ， 就 一 直 蒙 绕 在 我 的 脑海 里 。 第 8 章 对 部 署 
选项 的 透彻 研究 让 我 大 开眼 界 ， 了 人 解 到 Cloud Foundry 在 云 部 署 方面 是 如 此 简便 。 第 4 章 是 我 最 嘉 
欢 的 章节 之 一 ，Craig 揭 示 了 很 多 强大 的 选项 ,它们 能 很 方便 地 测试 Spring Boot 应 用 程序 。 从 一 开 
始 我 就 惊喜 于 Spring 的 测试 特性 ， 而 Spring Boot 1l VAZPERSINBUS SC. 

正如 上 文中 我 所 说 的 那样 ，Spring Boot 正 是 十 几 年 来 Java 社 区 所 探寻 的 那 种 框架 。 它 那 简 单 
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易 用 的 开发 特性 和 开 箱 即 用 的 运 维 能 力 ， 让 Java 开 发 再 度 趣味 横生 。 我 欣然 向 大 家 宣布 ，Spring 
和 Spring Boot 已 经 成 为 了 Netflix 新 持续 交付 平台 的 基础 。 而 且 ，Netflix 的 其 他 团队 也 参考 了 我 们 
的 做 法 ， 因 为 他 们 也 看 到 了 Spring Boot 的 巨大 益处 。 

我 怀 着 兴奋 与 激动 的 心情 , 向 大 家 强烈 推荐 Craig 的 书 。 作 为 Spring Boot 的 文档 ,本 书 可 谓 通 
俗 易 懂 、 趣 味 横生 ， 是 Spring Boot 征 服 Java 社 区 后 ， 大 家 戎 首 以 盼 的 佳作 。Craig 浅 显 易 懂 的 写作 
风格 , 对 Spring Boot 核 心 特性 与 功能 的 全 面 分 析 , 一 定 能 让 读者 对 Spring Boot 有 个 彻底 的 认识 (而 
且 在 满心 欢喜 的 同时 还 肃然 起 敬 )。 

Craig 加 油 ! Manning 出 版 社 加油 ! 那些 开发 出 Spring Boot 的 天 才 开 发 者 们 加 油 ! 请 你 们 一 定 
坚持 下 去 ! 正 是 你 们 确保 了 JVM 的 光明 未 来 。 




































































Andrew Glover 
Netflix 交 付 工 程 团队 经 理 
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在 1964 年 的 纽约 世界 博览 会 上 ， 沃 特 ' 迪士尼 向 世界 介绍 了 三 件 有 开创 意义 的 东西 :“ 小 小 

EF” (itsa small world ) “与 林肯 先生 共度 的 伟大 时 刻 ”( Great Moments with Mr. Lincoln ) 以 
及 “文明 演进 之 旋转 木马 ”( Carousel of Progress )。" 所 有 这 三 样 东 西 随后 都 搬 进 了 迪士尼 乐园 和 
迪士尼 世界 ， 你 今天 仍 能 看 见 它 们 。 
其 中 ,我 最 喜欢 的 是 “文明 演进 之 旋转 木马 ”， 这 大 约 也 是 沃 特 . 迪士尼 的 最 爱 之 一 。 这 既 
是 骑 行 ， 又 是 舞台 表演 ， 座 位 区 域 围绕 着 中 心 区 域 旋 转 ， 上 演 四 场 表 演 ， 讲 述 了 一 个 家 庭 在 20 
世纪 不 同时 代 (分 别 是 20 世 纪 初 、20 世 纪 20 年 代 、20 世 纪 40 年 代 和 近年 ) 的 故事 ,突出 了 不 同年 
代 技 术 的 进步 。 从 手 播 洗衣 机 ， 到 电灯 和 收音 机 ， 到 自动 洗 碗 机 和 电视 ， 再 到 电脑 和 声控 家 电 ， 
无 一 不 在 述说 着 创新 的 故事 。? 

在 每 幕 表演 中 ， 父 亲 (也 是 演出 的 叙述 者 ) 都 会 讲述 最 新 的 发 明 ， 并 带 上 一 句 “ 这 玩意 儿 不 
能 更 好 了 ”， 到 头 来 却 发 现 随 着 技术 的 进步 ， 它 的 确 变 得 更 好 了 。 

比 起 这 场 舞 台 演出 ，Spring 的 历史 要 短 得 多 。 但 是 对 于 Spring， 我 的 感受 和 “演进 老 侈 ” 
( Progress Dad ) 对 20 世 纪 的 体会 相似 。 似 乎 每 个 Spring 应 用 程序 都 让 开发 者 的 生活 更 上 一 个 台阶 ， 
仅 从 Spring 组 件 的 声明 和 织 人 方式 就 能 看 出 端倪 。 让 我 们 来 看 看 Spring 历史 中 的 一 些 演化 历程 。 

o Spring 1.0 的 出 现 彻底 改变 了 我 们 开发 企业 级 Java 应 用 程序 的 方式 。Spring 的 依赖 注入 与 声 

明 式 事务 意味 着 组 件 之 间 再 也 不 存在 紧 耦 合 ， 再 也 不 用 重量 级 的 EJB 了 。 这 玩意 儿 不 能 更 
好 了 。 

口 到 了 Spring 2.0， 我 们 可 以 在 配置 里 使 用 自 定 义 的 XML 命名 空间 ， 更 小 、 更 简单 易 懂 的 配 
置 文件 让 Spring 本 身 更 便于 使 用 。 这 玩意 儿 不 能 更 好 了 。 

a Spring 2.5 让 我 们 有 了 更 优雅 的 面向 注解 的 依赖 注入 模型 ( 即 ecomponent 和 eautowired 
注解 )， 以 及 面向 注解 的 Spring MVC 编 程 模型 。 不 用 再 去 显 式 地 声明 应 用 程序 组 件 了 ,也 
不 再 需要 去 继承 某 个 基础 的 控制 器 类 了 。 这 玩意 儿 不 能 更 好 了 。 

口 到 了 Spring 3.0， 我 们 有 了 一 套 基 于 Java 的 全 新 配置 ， 它 能 够 取代 XML。 在 Spring 3.1 里 ， 
一 系列 以 egnable 开 头 的 注解 进一步 完善 了 这 一 特性 。 终 于 ， 我 们 第 一 次 可 以 写 出 一 个 
没有 任何 XML 配置 的 Spring 应 用 程序 了 。 这 玩意 儿 不 能 更 好 了 。 












































































































































































































































CD 关于 这 届 世 博 会 里 迪士尼 相关 的 信息 ， 详 见 http:/www.dwz.cn/2Hrvyh 中 的 Disney influence 部 分 。 一 一 译 者 注 
© 关于 这 个 游乐 设施 ， 详 见 http://www.yesterland.com/progress.html 的 介绍 。 译 者 注 




















O Spring 4.0 对 条 件 化 配置 提供 了 支持 ， 根 据 应 用 程序 的 Classpath、 环 境 和 其 他 因素 ， 运 行 
时 决策 将 决定 使 用 哪些 配置 ， 忽 略 哪些 配置 。 那 些 决 策 不 需要 在 构建 时 通过 编写 脚本 确 
ET; 以 前 会 把 选 好 的 配置 放 在 部 署 的 包 里 ， 现 在 情况 不 同 了 。 这 玩意 儿 不 能 更 好 了 。 
现在 轮 到 Spring Boot 了 。 虽 然 Spring 的 每 个 版 本 都 让 我 们 觉得 一 切 都 不 能 更 好 了 ， 但 Spring 
Boot 还 是 向 我 们 证 明了 Spring 仍然 有 巨大 的 潜力 。 事 实 上， 我 相信 Spring Boot 是 长 久 以 来 Java 开 
发 历程 里 最 意义 深刻 、 激 动人 心 的 东西 。 

以 历代 Spring Framework 的 进步 为 基础 ，Spring Boot 实 现 了 自动 配置 , 这 让 Spring 能 够 智能 探 
测 正在 构建 何 种 应 用 程序 ， 自动 配置 必要 的 组 件 以 满足 应 用 程序 的 需要 。 对 于 那些 常见 的 配置 场 
景 ， 不 再 需要 显 式 地 编写 配置 了 ，Spring 会 蔡 你 料理 好 一 切 。 

选择 在 构建 时 和 运行 时 要 包含 在 应 用 程序 里 的 库 ， 往 往 要 花费 不 少 工夫 ， 而 Spring Boot 的 起 
步 依 赖 ( starter dependency ) 将 常用 依赖 聚合 在 一 起 ， 借 此 简化 一 切 。 它 不 仅 简化 了 你 的 构建 说 
明 ， 还 让 你 不 必 苦 思 和 冥想 特定 库 和 版 本 。 

针对 使 用 Groovy 来 开发 Spring 应 用 程序 ，Spring Boot 的 命令 行 界 面 提供 了 一 个 令 人 瞩目 的 选 
项 ， 它 将 Java 应 用 程序 开发 过 程 中 的 噪声 降 到 最 低 ， 开 发 方式 平易 近 人 。 有 了 Spring Boot CLI, 
就 不 再 需要 访问 方法 了 ， 不 再 需要 诸如 public 与 private 之 类 的 访问 修饰 符 ， 也 不 再 需要 分 号 
或 者 return 关 键 字 。 在 许多 场景 中 ，import 语 句 都 可 以 去 掉 。 因 为 你 是 在 命令 行 里 以 脚本 方式 
运行 应 用 程序 ， 所 以 连 构建 说 明 都 能 免 了 。 

Spring Boot 的 Actuator 让 你 能 一 宕 应 用 程序 运行 时 的 内 部 工作 细节 , 看 看 Spring 应 用 程序 上 下 
文 里 都 有 哪些 Bean ，Spring MVC 控 制 器 是 怎么 与 路 径 映 射 的 ， 应 用 程序 都 能 取 到 哪些 配置 属性 ， 
诸如 此 类 。 

Spring Boot 为 我 们 带 来 了 这 么 多 奇妙 的 特性 ， 这 玩意 儿 当 然 不 能 更 好 了 ! 

本 书 中 你 将 看 到 ,Spring Boot 着 实 计 Spring 比 以 前 更 好 了 。 我 们 将 一 同 去 了 解 自动 配置 Spring 
Boot 起 步 依 赖 、Spring Boot CLI 和 Actuator。 我 们 还 会 去 摆弄 一 下 Grails 的 最 新 版 本 ， 它 就 是 基于 
Spring Boot 的 。 临 近 未 尾 ， 你 也 许 会 觉得 Spring 不 可 能 更 好 了 。 

如 果 说 迪士尼 的 “文明 演进 之 旋转 木马 ”告诉 了 我 们 什么 事情 , 那 就 是 当 我 们 觉得 什么 东西 
不 可 能 更 好 了 的 时 候 ， 它 一 定 会 变 得 更 好 。Spring Boot 的 进步 正在 带 来 越 来 越 大 的 益处 。 真 的 难 
以 想象 Spring 还 能 变 得 更 好 ， 但 它 肯 定 会 更 好 。 毫 无 疑问 ，Spring 的 前 景 总 是 美好 的 。 
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Spring Boot 旨 在 简化 Spring 的 开发 ， 就 这 点 而 论 ，Spring Boot 涉 及 了 Spring 的 方方面面 。 用 一 
本 书 讲 清楚 Spring Boot 的 所 有 用 法 是 不 可 能 的 ， 因 为 这 必须 涵盖 Spring 本 身 所 支持 的 各 种 技术 。 
所 以 《Spring Boot 实 战 》 把 Spring Boot 大 致 分 为 4 个 主题 : 自动 配置 、 起 步 依 赖 、 命 令 行 界面 和 
Actuator。 书 中 还 会 讲 到 一 些 必要 的 Spring 特性 ， 但 重点 还 是 在 Spring Boot Eo 

《Spring Boot 实 战 》 面 向 的 是 全 体 Java 开 发 者 。 虽 然 读 者 需要 有 一 些 Spring 背景 , 但 Spring Boot 
让 那些 新 接触 Spring 的 人 也 更 容易 上 手 。 然 而 ， 因 为 本 书 的 重点 是 Spring Boot, KARA Spring 
本 身 ， 所 以 手边 再 准备 一 本 Spring 读物 也 许 效果 会 更 好 ， 比 如 说 《Spring 实战 (第 4 版 )》。 






































章 市 安排 


《Spring Boot 实 战 》 全 书 分 为 8 章 。 

a 第 1 章 会 对 Spring Boot 进 行 概述 ， 内 容 涵 盖 最 基本 的 自动 配置 、 起 步 依赖 、 命 令 行 界 面 和 

Actuator。 

口 第 2 章 会 进一步 深入 Spring Boot， 重 点 介绍 自动 配置 和 起 步 依赖 。 在 这 一 章 里 ， 你 将 用 很 

少 的 显 式 配置 来 构建 一 个 完整 的 Spring 应 用 程序 。 

口 第 3 章 是 对 第 2 章 的 补充 ， 演 示 了 如 何 通过 设置 应 用 程序 属性 来 改变 自动 配置 ， 或 者 在 自 

动 配置 无 法 满足 需要 时 彻底 覆盖 它 。 

a 在 第 4 章 里 我 们 会 看 到 如 何 为 Spring Boot 应 用 程序 编写 自动 化 集成 测试 。 

口 在 第 5 章 里 你 将 看 到 一 种 有 别 于 传统 Java 开 发 方式 的 做 法 ，Spring Boot CLI 能 让 你 通过 命 

令 行 来 运行 应 用 程序 ， 这 个 应 用 程序 完全 是 由 Groovy 脚 本 构成 的 。 

口 讲 到 Groovy， 第 6 章 会 介绍 Grails 3 ， 这 是 Grails 框 架 的 最 新 版 本 ， 它 基于 Spring Boot 

口 在 第 7 章 里 你 将 看 到 如 何 通过 Spring Boot 的 Actuator 了 解 运行 中 的 应 用 程序 , 以 及 它 是 如 何 
工作 的 。 你 还 会 看 到 如 何 使 用 Actuator 的 Web 端 点 、 远 程 shell 和 JMX MBean 对 应 用 程序 一 
SEE. 

口 第 8 章 讨论 了 各 种 部 署 Spring Boot 应 用 程序 的 方法 ， 包 括 传统 的 应 用 程序 服务 器 部 署 和 云 
部 署 。 
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编码 规范 及 代码 下 载 


书 中 包含 了 很 多 代码 示例 ， 这 些 代 码 使 用 了 等 宽 字体 ， 如 DispatcherServlet。 正 文中 出 
现 的 所 有 类 名 、 方 法 名 或 者 是 XML 片 段 也 会 用 这 种 字体 ,不 少 Spring 的 类 和 包 的 名 字 都 特别 长 (但 
是 一 目 了 然 )， 因 此 在 需要 时 会 使 用 续 行 符 Cms 书 中 的 代码 并 非 都 是 完整 的 ,通常 我 只 会 就 某 
个 特定 主题 摘出 类 中 的 一 两 个 方法 。 

你 可 以 在 Manning 出 版 社 的 网 站 上 下 载 书 中 应 用 程序 的 完整 代码 ， 地 址 是 www.manning.com/ 


books/spring-boot-in-action 。 


作者 在 线 


购买 本 书 的 读者 还 能 免费 访问 Manning 出 版 社 的 私有 Web 论 坛 , 在 那里 你 能 就 本 书 发 表 评论 ， 
询问 技术 问题 ， 向 作者 以 及 其 他 用 户 寻 求 帮助 。 如 需 访 问 并 订阅 该 论坛 ， 请 打开 浏览 器 访问 
www.manning.com/books/spring-boot-in-action。 该 页 面 提供 了 详细 的 信息 ， 告 诉 你 在 注册 后 如 何 
访问 论坛 ， 论 坛 里 都 能 提供 哪些 帮助 ， 以 及 论坛 的 管理 规则 。 

Manning 问 读者 承诺 ， 为 读者 与 读者 之 间 以 及 读者 与 作者 之 间 的 沟通 建立 桥梁 。 但 Manning 
并 不 保证 作者 在 论坛 中 的 参与 程度 , 他 们 在 论坛 上 投入 多 少 精力 是 全 凭 自愿 的 (并 且 是 无 偿 的 )。 
我 们 强烈 建议 你 向 作者 问 些 有 挑战 性 的 问题 ， 让 他 有 兴趣 留 在 论坛 里 。 

只 要 本 书 仍 在 销售 ， 你 就 能 在 出 版 商 的 网 站 上 查找 作者 在 线 论坛 及 其 讨论 归档 。 


天 于 封面 图 


本 书 封面 上 的 插画 题 为 “ 喀 山 坝 租 民族 服饰 ”(〈 Habit of a Tartar in Kasan )， 喀 山 是 俄罗斯 联 
邦 讨 划 斯坦 共和 国 首府 。 这 幅 图 选 自 Thomas Jefferys 的 《各 国 古 代 和 现代 服饰 集 》( 4 Collection of 
the Dresses of Different Nations, Ancient and Modern， 共 四 卷 ，1757 一 1772 年 间 出 版 于 伦敦 )， 该 书 
Hi yi PREJ, 这 些 插画 都 是 手工 上 色 、 铜 版 雕刻 ,还 用 了 阿拉 伯 树 胶 。 Thomas Jefferys( 1719—1771 ) 
被 誉 为 “乔治 三 世 国 王 的 御用 地 理学 家 ”( Geographer to King George II )。 他 是 一 名 英国 地 图 制 
图 师 , 是 当时 地 图 行业 的 领导 者 。 他 为 政府 和 其 他 官方 机 构 雕 刻 并 印刷 地 图 ， 还 制作 了 各 种 不 同 
的 商用 地 图 和 地 图 集 , 尤其 是 北美 洲 地 图 。 地 图 制图 师 的 工作 引发 了 他 调研 当地 民族 服饰 的 兴 
这 一 兴趣 在 这 套 服饰 集 里 体现 得 淋 沈 尽 致 。 

着 迷 于 远方 的 大 陆 , 为 了 消遣 而 去 旅行 ， 这 在 18 世 纪 晚 期 还 是 相对 新 鲜 的 现象 ， 而 像 这 套 服 
饰 集 这 样 的 合集 在 当时 非常 流行 ,向 观光 客 和 足 不 出 户 的 “游客 ”介绍 其 他 国家 的 居民 。Jefferys 
著作 中 异彩 纷呈 的 图 画 生 动 地 描绘 了 200 年 前 世界 各 国 的 特色 。 自 那 以 后 , 服饰 文化 发 生 了 变化 ， 
各 个 国家 与 地 区 之 间 一 度 非常 丰富 的 多 样 性 已 逐渐 消失 。 现在 , 不 同 大 洲 的 居民 往往 很 难 通过 服 
饰 来 分 辨 了 。 也 许 , 我 们 该 乐观 一 点 儿 ， 我 们 用 文化 和 视觉 上 的 多 样 性 换 来 了 更 多 样 的 人 生 , 或 
者 说 是 更 多 样 、 更 有 趣 、 更 智能 的 科技 人 生 。 
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在 很 难 从 外 观 上 分 辨 不 同 计算 机 读物 的 年 代 里 ，Manning 出 版 社 脱颖而出 ， 在 图 书 封面 上 采 
用 了 两 个 世纪 以 前 各 地 居民 丰富 多 样 的 形象 , 以 此 体现 了 计算 机 行业 别出心裁 、 独 具 创 新 的 特性 。 
这 些 都 得 归功 于 Jeffreys 的 绘画 。 


电子 书 
扫描 如 下 二 维 码 ， 即 可 购买 本 书 电子 版。 
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本 章 内 容 

口 Spring Boot 简 化 Spring 应 用 程序 开发 
口 Spring Boot 的 基本 特性 

口 Spring Boot 工 作 区 的 设置 








Spring Framework 已 有 十 余年 的 历史 了 ， 已 成 为 Java 应 用 程序 开发 框架 的 事实 标准 。 在 如 此 
修 久 的 历史 背景 下 ， 有 人 可 能 会 认为 Spring 放 慢 了 脚步 ， 身 在 了 自己 的 荣誉 敌 上 ， 再 也 做 不 出 什 
么 新 鲜 的 东西 ， 或 者 是 让 人 激动 的 东西 。 甚 至 有 人 说 ，Spring 是 遗留 项 目 ， 是 时 候 去 看 看 其 他 创 
新 的 东西 了 。 

这 些 人 说 得 不 对 。 

Spring 的 生态 圈 里 正在 出 现 很 多 让 人 激动 的 新 鲜 事物 ， 涉 及 的 领域 涵盖 云 计 算 、 大 数据 、 无 
模式 的 数据 持久 化 、 响 应 式 编程 以 及 客户 端 应 用 程序 开发 。 

在 过 去 的 一 年 多 时 间 里 ,最 让 人 兴奋 .回头 率 最 高 .最 能 改变 游戏 规则 的 东西 ,大 概 就 是 Spring 
Boot 了 。Spring Boot 提 供 了 一 种 新 的 编程 范式 ， 能 在 最 小 的 阻力 下 开发 Spring 应 用 程序 。 有 了 它 ， 
你 可 以 更 加 敏捷 地 开发 Spring 应 用 程序 ， 专 注 于 应 用 程序 的 功能 ， 不 用 在 Spring 的 配置 上 多 花 功 
夫 ， 甚 至 完全 不 用 配置 。 实 际 上 ，Spring Boot 的 一 项 重要 工作 就 是 让 Spring 不 再 成 为 你 成 功 路 上 
的 绊脚石 。 

本 书 将 探索 Spring Boot 开 发 的 诸多 方面 ， 但 在 开始 前 ， 我 们 先 大 概 了 解 一 下 Spring Booth 





























































































































1.1 Spring 风云 再 起 


Spring 诞生 时 是 Java 企 业 版 (Java Enterprise Edition ，JEE， 也 称 J2EE ) 的 轻 量 级 代替 品 。 无 需 
开发 重量 级 的 Enterprise JavaBean (EJB )，Spring 为 企业 级 Java 开 发 提供 了 一 种 相对 简单 的 方法 ， 通 
过 依赖 注入 和 面向 切面 编程 ， 用 简单 的 Java 对 象 ( Plain Old Java Object, POJO ) 实现 了 EJB 的 功能 。 
虽然 Spring 的 组 件 代码 是 轻 量 级 的 , 但 它 的 配置 却 是 重量 级 的 。 一 开始 ,Spring 用 XML 配置 ， 
而 且 是 很 多 XML 配置 。Spring 2.5 引 入 了 基于 注解 的 组 件 扫描 ， 这 消除 了 大 量 针对 应 用 程序 自身 
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组 件 的 显 式 XML 配置 。Spring 3.0 引 入 了 基于 Java 的 配置 ， 这 是 一 种 类 型 安全 的 可 重 构 配置 方式 ， 
可 以 代替 XML 。 

尽管 如 此 ， 我 们 依旧 没 能 逃脱 配置 的 魔爪 。 开 启 某 些 Spring 特性 时 ， 比 如 事务 管理 和 Spring 
MVC， 还 是 需要 用 XML 或 Java 进 行 显 式 配置 。 启 用 第 三 方 库 时 也 需要 显 式 配 置 ， 比 如 基 
Thymeleaf 的 Web 视 图 。 配 置 Servlet 和 过 滤器 (比如 Spring 的 DispatcherSservlet ) 同样 需要 在 
web.xml 或 Servlet 初 始 化 代码 里 进行 显 式 配置 。 组 件 扫 描 减 少 了 配置 量 , Java 配 置 让 它 看 上 去 简洁 
不 少 , 但 Spring 还 是 需要 不 少 配置 。 

所 有 这 些 配置 都 代表 了 开发 时 的 损耗 。 因 为 在 思考 Spring 特性 配置 和 解决 业务 问题 之 间 需 要 
进行 思维 切换 ， 所 以 写 配 置 挤占 了 写 应 用 程序 逻辑 的 时 间 。 和 所 有 框架 一 样 ，Spring 实 用 ， 但 与 
此 同时 它 要 求 的 回报 也 不 少 。 

除 此 之 外 , 项 目的 依赖 管理 也 是 件 吃力 不 讨好 的 事情 。 决定 项 目 里 要 用 哪些 库 就 已 经 够 让 人 
头痛 的 了 ， 你 还 要 知道 这 些 库 的 哪个 版 本 和 其 他 库 不 会 有 冲突 ， 这 难题 实在 太 棘手 。 

FE, 依赖 管理 也 是 一 种 损耗 ,添加 依赖 不 是 写 应 用 程序 代码 。 一 旦 选 错 了 依赖 的 版 本 ， 随 
之 而 来 的 不 兼容 问题 毫 无 疑问 会 是 生产 力 杀 手 。 

Spring Boot 计 这 一 切 成 为 了 过 去 。 


























































































































1.1.1 重新 认识 Spring 


假设 你 受命 用 Spring 开 发 一 个 简单 的 Hello World Web 应 用 程序 。 你 该 做 什么 ”我 能 想到 一 些 
基本 的 需要 。 
口 一 个 项 目 结 构 , 其 中 有 一 个 包含 必要 依赖 的 Maven 或 者 Gradle 构 建文 件 , 最 起 码 要 有 Spring 
MVC 和 Servlet API 这 些 依赖 。 
OQ 一 个 web.xml 文 件 (或 者 一 个 WepbApplicationInitializer 实 现 )， 其 中 声明 了 Spring 
的 DispatcherServlet。 
口 一 个 启用 了 Spring MVC 的 Spring 配置 。 
a 一 个 控制 器 类 ， 以 “Hello World” 响 应 HTTP 请 求 。 
口 一 个 用 于 部 署 应 用 程序 的 Web 应 用 服务 器 ， 比 如 Tomcat。 

最 让 人 难以 接受 的 是 ， 这 份 清单 里 只 有 一 个 东西 是 和 Hello World 功 能 相关 的 ， 即 控制 器 ， 剩 

下 的 都 是 Spring 开发 的 Web 应 用 程序 必需 的 通用 样板 。 既 然 所 有 Spring Web 应 用 程序 都 要 用 到 它 

们 ， 那 为 什么 还 要 你 来 提供 这 些 东 西 呢 ? 

假设 这 里 只 需要 控制 器 。 代 码 清 单 1-1 所 示 基 于 Groovy 的 控制 器 类 就 是 一 个 简单 而 完整 的 
Spring 应 用 程序 。 


代码 清单 1-1 一 个 完整 的 基于 Groovy 的 Spring 应 用 程序 
@RestController 
class HelloController { 




























































































GRequestMapping("/" 
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def hello() ( 
return "Hello World" 
) 


} 

这 里 没有 配置 ， 没 有 web.xml， 没 有 构建 说 明 ， 甚 至 没有 应 用 服务 器 ， 但 这 就 是 整个 应 用 程 
序 了 。Spring Boot 会 搞定 执行 应 用 程序 所 需 的 各 种 后 勤 工 作 ， 你 只 要 搞定 应 用 程序 的 代码 就 好 。 

假设 你 已 经 装 好 了 Spring Boot 的 命令 行 界面 ( Command Line Interface，CLI )， 可 以 像 下 面 这 
样 在 命令 行 里 运行 HelloCcontroller: 






































$ spring run HelloController.groovy 
想必 你 已 经 注意 到 了 ， 这 里 甚至 没有 编译 代码 ，Spring Boot CLI 可 以 运行 未 经 编译 的 代码 。 

之 所 以 选择 用 Groovy 来 写 这 个 控制 器 示例 , 是 因为 Groovy 语 言 的 简洁 与 Spring Boot 的 简洁 有 
异曲同工 之 妙 。 但 Spring Boot 并 不 强制 要 求 使 用 Groovy。 实 际 上 ， 本 书 中 的 很 多 代码 都 是 用 Java 
写 的 ,但 在 恰当 的 时 候 ， 偶 尔 也 会 出 现 一 些 Groovy 代 码 。 

不 要 客气 ， 直 接 跳 到 1.2.1 节 吧 ， 看 看 如 何 安装 Spring Boot CLI， 这 样 你 就 能 试 着 编写 这 个 小 
小 的 Web 应 用 程序 了 。 现 在 ， 你 将 看 到 Spring Boot 的 关键 部 分 ， 看 到 它 是 如 何 改变 Spring 应 用 程 
序 的 开发 方式 的 。 

































































1.1.2 Spring Boot 精 要 


Spring Boot 将 很 多 魔法 带 入 了 Spring 应 用 程序 的 开发 之 中 ， 其 中 最 重要 的 是 以 下 四 个 核心 。 
口 自动 配置 : 针对 很 多 Spring 应 用 程序 常见 的 应 用 功能 ，Spring Boot 能 自动 提供 相关 配置 。 
O 起 步 依 赖 : 告诉 Spring Boot 需 要 什么 功能 ， 它 就 能 引入 需要 的 库 。 
O 命令 行 界 面 : 这 是 Spring Boot 的 可 选 特性 ， 借 此 你 只 需 写 代码 就 能 完成 完整 的 应 用 程序 ， 
无 需 传统 项 目 构 建 。 
口 Actuator: 让 你 能 够 深入 运行 中 的 Spring Boot 应 用 程序 ， 一 探究 竟 。 

每 一 个 特性 都 在 通过 自己 的 方式 简化 Spring 应 用 程序 的 开发 。 本 书 会 探寻 如 何 将 它们 发 挥 到 
极致 ， 但 就 目前 而 言 ， 先 简单 看 看 它们 都 提供 了 哪些 功能 吧 。 

1. 自动 配置 

在 任何 Spring 应 用 程序 的 源 代 码 里 , 你 都 会 找到 Java 配 置 或 XML 配置 ( 抑或 两 者 此 有 ), 它们 
为 应 用 程序 开启 了 特定 的 特性 和 功能 。 举 个 例子 ， 如 果 你 写 过 用 JDBC 访 问 关 系 型 数据 库 的 应 用 
程序 ， 那 你 一 定 在 Spring 应 用 程序 上 下 文 里 配置 过 JqbcTemplate 这 个 Bean。 我 打赌 那 段 配置 看 
起 来 是 这 样 的 : 

GBean 

public JdbcTemplate jdbcTemplate (DataSource dataSource) ( 


return new JdbcTemplate(dataSource); 


} 













































































4 第 1 章 X 门 





这 段 非常 简单 的 Bean 声 明 创 建 了 一 个 JdbcTemplate 的 实例 ， 注 人 了 一 个 Datasource 依 赖 。 
然 ， 这 意味 着 你 还 需要 配置 一 个 Datasource 的 Bean， 这 样 才能 满足 依赖 。 假 设 你 将 配置 一 个 
入 式 H2 数 据 库 作为 Datasource Bean， 完 成 这 个 配置 场景 的 代码 大 概 是 这 样 的 : 


GBean 
public DataSource dataSource() ( 
return new EmbeddedDatabaseBuilder() 
.SetType (EmbeddedDatabaseType.H2) 
.addScripts('schema.sql', 'data.sqgl') 
.build(); 


BE UK 














} 
这 个 Bean 配 置 方法 创建 了 一 个 能 入 式 数据 库 , 并 指定 在 该 数据 库 上 执行 两 段 SQL 脚 本 。buila() 
方法 返回 了 一 个 指向 该 数据 库 的 引用 。 

这 两 个 Bean 配 置 方法 都 不 复杂 ， 也 不 是 很 长 ， 但 它们 只 是 典型 Spring 应 用 程序 配置 的 一 小 部 
分 。 除 此 之 外 ， 还 有 无 数 Spring 应 用 程序 有 着 完全 相同 的 方法 。 所 有 需要 用 到 艇 入 式 数据 库 和 
JdbcTemplate 的 应 用 程序 都 会 用 到 那些 方法 。 简 而 言 之 ， 这 就 是 一 个 样板 配置 。 

既然 它 如 此 常见， 那 为 什么 还 要 你 去 写 呢 ? 

Spring Boot 会 为 这 些 常 见 配 置 场景 进行 自动 配置 。 如 果 Spring Boot 在 应 用 程序 的 Classpath 里 
发 现 H2 数 据 库 的 库 ， 那 么 它 就 自动 配置 一 个 般 入 式 H2 数 据 库 。 如 果 在 Classpath 里 发 现 
JdbcTemplate, 那么 它 还 会 为 你 配置 一 个 JabcTemplate 的 Bean。 你 无 需 操 心 那 些 Bean 的 配置 ， 
Spring Boot 会 做 好 准备 ， 随 时 都 能 将 其 注入 到 你 的 Bean 里 。 

Spring Boot 的 自 动 配置 远 不 止 内 入 式 数 据 库 和 JaqbcTemplate， 它 有 大 把 的 办 法 帮 你 减轻 配 
置 负担 ， 这 些 自动 配置 涉及 Java 持 久 化 API (Java Persistence API, JPA )、Thymeleaf 异 板 、 安 全 和 
Spring MVC。 第 2 章 会 深入 讨论 自动 配置 这 个 话题 。 

2. 起 步 依 赖 

























































































哪个 版 本 ? 哪个 版 本 不 会 和 项 目 中 的 其 他 依赖 发 生 冲 突 ? 

Spring Boot 通 过 起 步 依 赖 为 项 目的 依赖 管理 提供 帮助 。 起 步 依赖 其 实 就 是 特殊 的 Maven 依 
赖 和 Gradle 依 赖 ， 利 用 了 传递 依赖 解析 ， 把 常用 库 聚 合 在 一 起 ， 组 成 了 几 个 为 特定 功能 而 定制 
的 依赖 。 

举 个 例子 ， 假 设 你 正在 用 Spring MVC 构 造 一 个 REST API， 并 将 JSON (JavaScript Object 
Notation ) 作为 资源 表述 。 此 外 ， 你 还 想 运用 遵循 JSR-303 规 范 的 声明 式 校 验 ， 并 使 用 能 入 式 的 
Tomcat 服 务 需 来 提供 服务 。 要 实现 以 上 目标 ， 你 在 Maven 或 Gradle 里 至 少 需要 以 下 8 个 依赖 : 


D org.springframework:spring-core 












































D org.springframework:spring-web 
DQ org.springframework:spring-webmvc 


口 com.fasterxml.jackson.core:jackson-databind 








口 org.hibernate:hibernate-validator 
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DQ org.apache.tomcat.embed:tomcat-embed-core 


L] org.apache.tomcat.embed:tomcat-embed-el 





D org.apache.tomcat.embed:tomcat-embed-logging-juli 

不 过 ， 如 果 打 算 利用 Spring Boot 的 起 步 依赖 ， 你 只 需 添加 Spring Boot 的 Web 起 步 依赖 
(org.springframework.boot:spring-boot-starter-web ) e 仅 此 一 个 。 它 会 根据 依赖 
传递 把 其 他 所 需 依 赖 引 入 项 目 里 ， 你 都 不 用 考虑 它们 。 

比 起 减少 依赖 数量 ， 起 步 依赖 还 引入 了 一 些微 妙 的 变化 。 向 项 目 中 添加 了 Web 起 步 依赖 ， 实 
际 上 指定 了 应 用 程序 所 需 的 一 类 功能 。 因 为 应 用 是 个 Web 应 用 程序 ， 所 以 加 入 了 Web 起 步 依赖 。 
与 之 类 似 ， 如 果 应 用 程序 要 用 到 JPA 持 久 化 ， 那 么 就 可 以 加 入 jpa 起 步 依 赖 。 如 果 需 要 安全 功能 ， 
那 就 加 入 security 起 步 依赖 。 简 而 言 之 , 你 不 再 需要 考虑 支持 某 种 功能 要 用 什么 库 了 , 引入 相关 起 
步 依赖 就 行 。 

此 外 ，Spring Boot 的 起 步 依 赖 还 把 你 从 “需要 这 些 库 的 哪些 版 本 ”这 个 问题 里 解放 了 出 来 。 
起 步 依赖 引入 的 库 的 版 本 都 是 经 过 测试 的 ， 因 此 你 可 以 完全 放心 ， 它 们 之 间 不 会 出 现 不 兼容 的 
情况 。 

和 自动 配置 一 样 ， 第 2 章 就 会 深入 讨论 起 步 依 赖 。 

3. 命令 行 界 面 

除了 自动 配置 和 起 步 依赖 ，Spring Boot 还 提供 了 一 种 很 有 意思 的 新 方法 ， 可 以 快速 开发 Spring 
应 用 程序 。 正 如 之 前 在 1.1 节 里 看 到 的 那样 , Spring Boot CLI 让 只 写 代 码 即 可 实现 应 用 程序 成 为 可 能 。 

Spring Boot CLI 利 用 了 起 步 依 赖 和 自动 配置 ， 让 你 专注 于 代码 本 身 。 不 仅 如 此 ， 你 是 否 注意 
到 代码 清单 1-1 里 没有 import? CLI 如 何 知 道 RequestMapping 和 RestController 来 自 哪个 包 
呢 ? 说 到 这 个 问题 ， 那 些 类 最 终 又 是 怎么 跑 到 Classpath 里 的 呢 ? 

说 得 简单 一 点 ，CLI 能 检测 到 你 使 用 了 哪些 类 ， 它 知道 要 向 Classpath 中 添加 哪些 起 步 依 赖 才 
能 让 它 运转 起 来 。 一 旦 那些 依赖 出 现在 Classpath 中 ， 一 系列 自动 配置 就 会 接 唾 而 来 ， 确 保 启用 
DispatcherServlet 和 Spring MVC， 这 样 控制 器 就 能 响应 HTTP 请 求 了 。 

Spring Boot CLI 是 Spring Boot 的 非 必 要 组 成 部 分 。 虽 然 它 为 Spring 带 来 了 惊人 的 力量 ， 大 大 
简化 了 开发 , 但 也 引入 了 一 套 不 太 常 规 的 开发 模型 。 要 是 这 种 开发 模型 与 你 的 口味 相去 甚 远 ， 那 
也 没关系 , 抛 开 CLI， 你 还 是 可 以 利用 Spring Boot 提 供 的 其 他 东西 。 不 过 如 果 喜 欢 CLI， 你 一 定 想 
看 看 第 $ 章 ， 其 中 深入 探讨 了 Spring Boot CLI 

4. Actuator 

Spring Boot 的 最 后 一 块 “ 拼 图 ”是 Actuator， 其 他 几 个 部 分 旨 在 简化 Spring 开发 ， 而 Actuator 
则 要 提供 在 运行 时 检视 应 用 程序 内 部 情况 的 能 力 。 安 装 了 Actuator 就 能 突 探 应 用 程序 的 内 部 情况 
Y, t PANT: 

口 Spring 应 用 程序 上 下 文 里 配置 的 Bean 





































































































































































































(D Spring Boot 起 步 依 赖 基本 都 以 spring-boot-starter 打 头 ， 随 后 是 直接 代表 其 功能 的 名 字 ， 比 如 web test, 
下 文 出 现 起 步 依赖 的 名 字 时 ， 可 能 就 直接 用 其 前 绥 后 的 单词 来 表示 了 。 一 一 译 者 注 
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口 Spring Boot 的 自动 配置 做 的 决策 

口 应 用 程序 取 到 的 环境 变量 、 系 统 属性 、 配 置 属性 和 命令 行 参数 

口 应 用 程序 里 线程 的 当前 状态 

口 应 用 程序 最 近 处 理 过 的 HTTP 请 求 的 追踪 情况 

口 各 种 和 内 存 用 量 、 垃 圾 回收 、Web 请 求 以 及 数据 源 用 量 相关 的 指标 
Actuator 通 过 Web 端 点 和 shell 界 面向 外 界 提供 信息 。 如 果 要 借助 shell 界 面 ， 你 可 以 打开 SSH 

( Secure Shell )， 登 入 运行 中 的 应 用 程序 ， 发 送 指 令 查 看 它 的 情况 。 
第 7 章 会 详细 探索 Actuator 的 功能 。 







































































1.1.3 Spring Boot 不 是 什么 


为 Spring Boot 实 在 是 太 惊 艳 了 ， 所 以 过 去 一 年 多 的 时 间 里 有 不 少 和 它 相 关 的 言论 。 原 先 听 
到 或 看 到 的 东西 可 能 给 你 造成 了 一 些 误解 ， 继 续 学 习 本 书 前 应 该 先 澄清 这 些 误会 。 

首先 ，Spring Boot 不 是 应 用 服务 器 。 这 个 误解 是 这 样 产生 的 : Spring Boot 可 以 把 Web 应 用 程 
序 变 为 可 自 执行 的 JAR 文 件 ,不 用 部 署 到 传统 Java 应 用 服务 器 里 就 能 在 命令 行 里 运行 。 Spring Boot 
在 应 用 程序 里 租 入 了 一 个 Servlet 容 器 ( Tomcat、Jetty 或 Undertow )， 以 此 实现 这 一 功能 。 但 这 是 
内 纶 的 Servlet 容 器 提供 的 功能 ， 不 是 Spring Boot 实 现 的 。 

与 之 类 似 ，Spring Boot 也 没有 实现 诸如 JPA 或 JMS ( Java Message Service，Java 消 息 服务 ) 之 
类 的 企业 级 Java 规 范 。 它 的 确 支持 不 少 企业 级 Java 规 范 ， 但 是 要 在 Spring 里 自动 配置 支持 那些 特 
性 的 Bean。 例 如 ，Spring Boot 没 有 实现 JPA， 不 过 它 自 动 配置 了 某 个 JPA 实 现 ( 比如 Hibernate ) 的 
Bean， 以 此 支持 JPA。 

最 后 ，Spring Boot 没 有 引入 任何 形式 的 代码 生成 ， 而 是 利用 了 Spring 4 的 条 件 化 配置 特性 ， 
以 及 Maven 和 Gradle 提 供 的 传递 依赖 解析 ， 以 此 实现 Spring 应 用 程序 上 下 文 里 的 自动 配置 。 

简 而 言 之 ,从 本 质 上 来 说 ,Spring Boot 就 是 Spring , 它 做 了 那些 没有 它 你 自己 也 会 去 做 的 Spring 
Bean 配 置 。 谢 天 谢 地 , 幸好 有 Spring,， 你 不 用 再 写 这 些 样板 配置 了 , 可 以 专注 于 应 用 程序 的 逻辑 ， 
这 些 才 是 应 用 程序 独一无二 的 东西 。 

现在 , 你 应 该 对 Spring Boot 有 了 大 概 的 认识 , 是 时 候 构 建 你 的 第 一 个 Spring Boot 应 用 程序 了 。 
先 从 重要 的 事情 开始 ， 该 怎么 人 手 呢 ? 



































































































































1.2 Spring Boot 入 门 


从 根本 上 来 说 ，Spring Boot 的 项 目 只 是 普通 的 Spring 项 目 ， 只 是 它们 正好 用 到 了 Spring Boot 
的 起 步 依赖 和 自动 配置 而 已 。 因 此 ， 那 些 你 早已 熟悉 的 从 头 创建 Spring 项 目的 技术 或 工具 ， 都 能 
用 于 Spring Boot 项 目 。 然 而 ， 还 是 有 一 些 简便 的 途径 可 以 用 来 开局 一 个 新 的 Spring Boot 项 目 。 

最 快 的 方法 就 是 安装 Spring Boot CLI, 安装 后 就 可 以 开始 写 代码 ， 如 代码 清单 1-1， 接 着 通过 
CLI 来 运行 就 好 。 
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1.2.1 X Spring Boot CLI 


如 前 文 所 述 ，Spring Boot CLI 提 供 了 一 种 有 趣 的 、 不 同 寻 常 的 Spring 应 用 程序 开发 方式 。 第 $ 
章 里 会 详细 解释 CLI 提 供 的 功能 。 这 里 先 来 看 看 如 何 安装 Spring Boot CLI， 这 样 才能 运行 代码 清 
单 1-1。 

Spring Boot CLI 有 好 儿 种 安装 方式 。 
口 用 下 载 的 分 发 包 进行 安装 。 
口 用 Groovy Environment Manager 进 行 安装 。 
口 通过 OS X Homebrew 进 行 安 装 。 
口 使 用 MacPorts 进 行 安装 。 
我 们 分 别 看 一 下 这 几 种 方式 。 除 此 之 外 ， 还 要 了 解 如 何 安装 Spring Boot CLI 的 命令 行 补 全 支持 ， 
如 果 你 在 BASH 或 zsh shell 里 使 用 CLI， 这 会 非常 有 用 GUT, 各 位 Windows 用 户 )。 先 来 看 看 如 
何 用 分 发 包 手 工 安装 Spring Boot CLIE, 

1. 手工 安装 Spring Boot CLI 

安装 Spring Boot CLI 最 直接 的 方法 大 约 是 下 载 、 解 压 , 随后 将 它 的 bn 目录 添加 到 系统 路 径 里 。 
你 可 以 从 以 下 两 个 地 址 下 载 分 发 包 : 
Q http://repo.spring.io/release/org/springframework/boot/spring-boot-cli/1.3.0.RELEASE/spring- 
boot-cli-1.3.0.RELEASE-bin.zip 
O http;//repo.spring.io/release/org/springframework/boot/spring-boot-cli/1.3.0.RELEASE/spring- 

boot-cli-1.3.0.RELEASE-bin.tar.gz 

下 载 完 成 之 后 ， 把 它 解压 到 文件 系统 的 任意 目录 里 。 在 解压 后 的 目录 里 ， 你 会 找到 一 个 bin 
目录 ， 其 中 包含 了 一 个 spring.bat 脚 本 ( 用 于 Windows 环 境 ) 和 一 个 spring 脚 本 ( 用 于 Unix 环 境 )。 
把 这 个 bin 目 录 添 加 到 系统 路 径 里 ， 然 后 就 能 使 用 Spring Boot CLIT o 


为 Spring Boot 建 立 符号 链接 ”如果 是 在 安装 了 Unix 的 机 器 上 使 用 Spring Boot CLI, 
最 好 建立 一 个 指向 解压 目录 的 符号 链接 ， 然 后 把 这 个 符号 链接 添加 到 系统 路 径 ， 而 不 是 
实际 的 目录 。 这 样 后 续 升级 Spring Boot 新 版 本 ， 或 是 转换 版 本 ， 都 会 很 方便 ， 只 要 重建 
一 下 符号 链接 ， 指 向 新 版 本 就 好 了 。 
你 可 以 先 浅 尝 轻 止 ， 看 看 你 所 安装 的 CLI 版 本 号 : 
$ spring --version 


如 果 一 切 正 常 ， 你 会 看 到 安装 好 的 Spring Boot CLI 的 版 本 号 。 

虽然 这 是 手工 安装 , 但 一 切 都 很 容易 , 而 且 不 要 求 你 安装 任何 附加 的 东西 。 如 果 你 是 Windows 
用 户 ， 也 别 无 选择 ， 这 是 唯一 的 安装 方式 。 但 如 果 你 使 用 的 是 Unix 机 右 ， 而 且 想 要 稍微 自动 化 一 
点 的 方式 ， 那 么 可 以 试 试 Software Development Kit Manager. 

2. 使 用 Software Development Kit Manager 进 行 安装 

软件 开发 工具 管理 包 (Software Development Kit Manager, SDKMAN, ， 曾 用 简称 GVM ) 也 
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能 用 来 安装 和 管理 多 版 本 Spring Boot CLI。 使 用 前 ， 你 需要 先 从 http://sdkman.io 获 取 并 安装 
SDKMAN。 最 简单 的 安装 方式 是 使 用 命令 行 : 








$ curl -s get.sdkman.io | bash 
跟随 输出 的 指示 就 能 完成 SDKMAN 的 安装 。 在 我 的 机 器 上 ， 我 在 命令 行 里 执行 了 如 下 命令 : 

$ source "/Users/habuma/.sdkman/bin/sdkman-init.sh" 

注意 ,用 户 不 同 ， 这 条 命令 也 会 有 所 不 同 。 我 的 用 户 目 录 是 /Users/habuma， 因 此 这 也 是 shell 
脚本 的 根 路 径 。 你 需要 根据 实际 情况 稍 作 调整 。 一 旦 安装 好 了 SDKMAN ， 就 可 以 用 下 面 的 方式 
来 安装 Spring Boot CLI T : 





























$ sdk install springboot 
$ spring --version 


假设 一 切 正 常 ， 你 将 看 到 Spring Boot 的 当前 版 本 号 。 

如 果 想 升级 新 版 本 的 Spring Boot CLI[， 只 需 安装 并 使 用 即 可 。 使 用 SDKMAN 的 1ist 命 令 可 
以 找到 可 用 的 版 本 : 

$ sdk list springboot 
1ist 命 令 列 出 了 所 有 可 用 版 本 ， 包 括 已 经 安装 的 和 正在 使 用 的 。 从 中 选择 一 个 进行 安装 ， 然 后 
就 可 以 正常 使 用 。 举 例 来 说 ， 要 安装 Spring Boot CLI 1.3.0.RELEASE， 直 接 使 用 instal1 命 令 ， 
指定 版 本 号 : 

$ sdk install springboot 1.3.0.RELEASE 
这 样 就 会 安装 一 个 新 版 本 , 随后 你 会 被 询问 是 否 将 其 设置 为 默认 版 本 。 要 是 你 不 想 把 它 作为 默认 
版 本 ， 或 者 想 要 切换 到 另 一 个 版 本 ， 可 以 用 use 命 令 : 

$ sdk use springboot 1.3.0.RELEASE 

如 果 你 希望 把 那个 版 本 作为 所 有 shell 的 默认 版 本 ， 可 以 使 用 aefault 命 令 : 

$ sdk default springboot 1.3.0.RELEASE 

使 用 SDKMAN 来 管理 Spring Boot CLI 有 一 个 好 处 ,你 可 以 便捷 地 在 Spring Boot 的 不 同 版 本 之 
间 切 换 。 这 样 你 可 以 在 正式 发 布 前 试用 快照 版 本 ( snapshot )、 里 程 碑 版 本 ( milestone ) 和 尚未 正 
式 发 布 的 候选 版 本 (release candidate )， 试 用 后 再 切 回 稳定 版 本 进行 其 他 工作 。 

3. 使 用 Homebrew 进 行 安装 

如 果 要 在 OSX 的 机 器 上 进行 开发 ， 你 还 可 以 用 Homebrew 来 安装 Spring Boot CLI。Homebrew 
是 OSX 的 包 管 理 器 ， 用 于 安装 多 种 不 同 应 用 程序 和 工具 。 要 安装 Homebrew， 最 简单 的 方法 就 是 
运行 安装 用 的 Ruby 脚 本 : 


ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/ 
master/install)" 


你 可 以 在 http://brew.sh 看 到 更 多 关于 Homebrew 的 内 容 ( 还 有 安装 方法 )。 
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要 用 Homebrew 来 安装 Spring Boot CLI， 你 需要 引入 Pivotal 的 tap": 
$ brew tap pivotal/tap 

在 有 了 Pivotal 的 tap 后 ， 就 可 以 像 下 面 这 样 安装 Spring Boot CLI T : 
$ brew install springboot 


Homebrew 会 把 Spring Boot CLI 安 装 到 /usr/local/bin， 之 后 可 以 直接 使 用 。 可 以 通过 检查 版 本 
号 来 验证 安装 是 否 成 功 : 

$ spring --version 

这 条 命令 应 该 会 返回 刚才 安装 的 Spring Boot 版 本 号 。 你 也 可 以 运行 代码 清单 1-1 看 看 。 

4. 使 用 MacPorts 进 行 安装 

OS X 用 户 还 有 另 一 种 安装 Spring Boot CLI 的 方法 ， 即 使 用 MacPorts， 这 是 Mac OS X 上 男 一 个 
流行 的 安装 工具 。 要 使 用 MacPorts 来 安装 Spring Boot CLI， 必 须 先 安装 MacPorts ， 而 MacPorts 还 
要 求 安 装 Xcode。 此 外 ， 使 用 不 同 版 本 的 OS X 时 ，MacPorts 的 安装 步骤 也 会 有 所 不 同 。 因 此 我 建 
议 你 根据 https://www.macports.org/install.php 的 安装 指南 来 安装 MacPorts。 

一 旦 安装 好 了 MacPorts， 就 可 以 用 以 下 命令 来 安装 Spring Boot CLI T : 



































$ sudo port install spring-boot-cli 














MacPorts 会 把 Spring Boot CLI 安 装 到 /opt/local/share/java/spring-boot-cli， 并 在 /opt/local/bin 里 
放 一 个 指向 其 可 执行 文件 的 符号 链接 。 在 安装 MacPorts 后 , /opt/local/bin 这 个 目录 应 该 就 在 系统 路 
径 里 了 。 你 可 以 检查 版 本 号 来 验证 安装 是 否 成 功 : 

$ spring --version 

这 条 命令 应 该 会 返回 刚才 安装 的 Spring Boot 的 版 本 号 。 你 也 可 以 运行 代码 清单 1-1， 看 看 效 
果 如 何 。 

5. 开启 命令 行 补 全 

Spring Boot CLI 为 基于 CLI 的 应 用 程序 的 运行 、 打 包 和 测试 提供 了 一 套 好 用 的 命令 。 而 且 ， 
个 命令 都 有 好 多 选项 。 要 记 住 这 些 东 西 实 属 不 易 , 命令 行 补 全 能 帮助 记忆 怎么 使 用 Spring Boot CLI。 

如 果 用 Homebrew 安 装 Spring Boot CLI, 那么 命令 行 补 全 已 经 安装 完毕 。 但 如 果 是 手工 安装 或 
者 用 SDKMAN 安 装 的 ， 那 就 需要 执行 脚本 或 者 手工 安装 。( 如 果 是 通过 MacPorts 安 装 的 Spring 
Boot CLI， 那 么 你 不 必 考 虑 命令 行 补 全 。) 

你 可 以 在 Spring Boot CLI 安 装 目 录 的 shell-completion 子 目录 里 找到 补 全 脚本 。 有 两 个 不 同 的 
脚本 ， 一 个 是 针对 BASH 的 ， 另 一 个 是 针对 zsh 的 。 要 使 用 BASH 的 补 全 脚本 ， 可 以 在 命令 行 里 键 
入 以 下 命令 (假设 安装 时 用 的 是 SDKMAN ): 


$ . -/.sSdkman/springboot/current/shell-completion/bash/spring 

























































































(D tap 是 向 Homebrew 添 加 额外 仓库 的 一 种 途径 .Pivotal 是 Spring 及 Spring Boot 背 后 的 公司 ,通过 它 的 tap 可 以 安装 Spring 
Boot。 
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这 样 ， 在 当前 的 shell 里 就 可 以 使 用 Spring Boot CLI 的 补 全 功能 了 ,但 每 次 开启 一 个 新 的 shell 
都 要 重新 执行 一 次 上 面 的 命令 才 行 。 你 也 可 以 把 这 个 脚本 复制 到 你 的 个 人 或 系统 脚本 目录 里 , 这 
个 目录 的 位 置 在 不 同 的 Unix 里 也 会 有 所 不 同 ， 可 以 参考 系统 文档 (Google) 了 解 细节 。 

开启 了 命令 行 补 全 之 后 , 在 命令 行 里 键入 spring 命 令 ， 然 后 按 Tab 键 就 能 看 到 下 一 步 该 输 什 
么 的 提示 。 选 中 一 个 命令 后 ,键入 -- ( 两 个 连 字 符 ) 后 再 按 Tab ， 就 会 显示 出 该 命令 的 选项 列表 。 

如 果 你 在 Windows 上 进行 开发 ， 或 者 没有 用 BASH 或 zsh， 那 就 无 缘 使 用 这 些 命令 行 补 全 脚本 
了 。 尽 管 如 此 ， 如 果 你 用 的 是 Spring Boot CLI 的 shell， 那 一 样 也 有 命令 补 全 : 


$ spring shell 


和 BASH、zsh 的 命令 补 全 脚本 (在 BASH/zsh shell 里 执行 的 ) 不 同 ，Spring Boot CLI shell 
新 开 一 个 特别 针对 Spring Boot 的 shell， 在 里 面 可 以 执行 各 种 CLI 命 令 ，Tab 键 也 能 有 命令 补 全 。 

Spring Boot CLIJ Spring Boot 提 供 了 快速 上 手 和 构建 简单 原型 应 用 程序 的 途径 。 稍 后 将 在 第 8 
章 中 讲 到 ， 在 正确 的 生产 运行 时 环境 下 ， 它 也 能 用 于 开发 生产 应 用 程序 。 

尽管 如 此 ， 与 大 部 分 Java 项 目的 开发 相 比 ，Spring Boot CLI 的 流程 还 是 不 太 符 合 常规 。 通 常 
情况 下 ，Java 项 目 用 Gradle 或 Maven 这 样 的 工具 构建 出 WAR 文 件 ， 再 把 这 些 文件 部 署 到 应 用 服务 
器 里 。 即 便 CLI 模 型 让 你 感到 不 太 和 舒服 ， 你 仍然 可 以 在 传统 方式 下 充分 利用 大 部 分 Spring Boot 特 
TE. "Spring Initializr 可 以 成 为 你 万 里 长 征 的 第 一 步 。 

















































































































1.2.2 ”使 用 Spring Initializr 初始 化 Spring Boot 项 目 


万 事 开 头 难 ,， 你 需要 设置 一 个 目录 结构 存放 各 种 项 目 内容 , 创建 构建 文件 ,并 在 其 中 加 入 各 
种 依赖 。Spring Boot CLI 消 除了 不 少 设置 工作 ,但 如 果 你 更 倾向 于 传统 Java 项 目 结构 ， 那 你 应 该 
看 看 Spring Initializr。 

Spring Initializr 从 本 质 上 来 说 就 是 一 个 Web 应 用 程序 , 它 能 为 你 生成 Spring Boot 项 目 结构 。 虽 
然 不 能 生成 应 用 程序 代码 ， 但 它 能 为 你 提供 一 个 基本 的 项 目 结构 ， 以 及 一 个 用 于 构建 代码 的 
Maven 或 Gradle 构 建 说 明文 件 。 你 只 需要 写 应 用 程序 的 代码 就 好 了 。 

Spring Initializr 有 几 种 用 法 。 
口 通过 Web 界 面 使 用 。 
口 通过 Spring Tool Suite 使 用 。 
口 通过 IntelliJ IDEA 使 用 。 
口 使 用 Spring Boot CLI 使 用 。 

下 面 分 别 看 看 这 几 种 用 法 ， 先 从 Web 界 面 开 始 。 

1. 使 用 Spring Initializr 的 Web 界 面 

要 使 用 Spring Initializr， 最 直接 的 办 法 就 是 用 浏览 器 打开 http://start.spring.io， 你 应 该 能 看 到 
类 似 图 1-1 的 一 个 表单 。 






















































































D 只 是 要 放弃 那些 用 到 Groovy 语 言 灵活 性 的 特性 ， 比 如 自动 依赖 和 import 解 析 。 
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表单 的 头 两 个 问题 是 ， 你 想 用 Maven 还 是 Gradle 来 构建 项 目 ， 以 及 使 用 Spring Boot 的 哪个 版 n 
本 。 程 序 默认 生成 Maven 项 目 ， 并 使 用 Spring Boot 的 最 新 版 本 ( 非 里 程 碑 和 快照 版 本 ), 但 你 也 可 
以 自由 选择 其 他 选项 。 
表单 左 侧 要 你 指定 项 目的 一 些 基 本 信息 。 最 起 码 你 要 提供 项 目的 Group 和 Artifact， 但 如 果 你 
点 击 了 “Switchto the full version” 链 接 ， 还 可 以 指定 额外 的 信息 ， 比 如 版 本 号 和 基础 包 名 。 这 些 
信息 是 用 来 生成 Maven 的 pom.xml 文 件 (或 者 Gradle 的 build.gradle 文 件 ) 的 。 
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图 1-1 Spring Initializr 是 生成 空 Spring 项 目的 Web 应 用 程序 ， 可 以 视 为 开发 过 程 的 第 一 步 


表单 右 侧 要 你 指定 项 目 依 赖 , 最 简单 的 方法 就 是 在 文本 框 里 键入 依赖 的 名 称 。 随 着 你 的 输入 
会 出 现 匹 配 依赖 的 列表 ， 选 中 一 个 〈 或 多 个 ) 依赖 ,选中 的 依赖 就 会 加 入 项 目 。 如 果 找 不 到 你 要 
的 依赖 ， 点击“Switch to the full version” 就 能 看 到 可 用 依赖 的 完整 列表 。 

要 是 你 眶 过 一 眼 附录 B ， 就 会 发 现 这 里 的 依赖 和 Spring Boot 起 步 依赖 是 对 应 的 。 实 际 上 ,在 
这 里 选中 依赖 ， 就 相当 于 告诉 Initializr 把 对 应 的 起 步 依赖 加 到 项 目的 构建 文件 里 。( 第 2 章 会 进 一 
步 讨论 Spring Boot 起 步 依 赖 。) 

HERA, 选 好 依赖 , 点 击 “Generate Project” 按 钮 ，Spring Initializr 就 会 为 你 生成 一 个 项 目 。 
浏览 器 将 会 以 ZIP 文 件 的 形式 (文件 名 取决 于 Artifact 字 段 的 内 容 ) 把 这 个 项 目下 载 下 来 。 根 据 你 
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的 选择 ,ZIP 文 件 的 内 容 也 会 略 有 不 同 。 不管 怎 样 ，ZIP 文 件 都 会 包含 一 个 极其 基础 的 项 目 , 让 你 
能 着 手 使 用 Spring Boot 开 发 应 用 程序 。 
举例 来 说 ， 假 设 你 在 Spring Initializr 里 指定 了 如 下 信息 。 
D Artifact: myapp 
Q £4: myapp 
Q 类 型 : GradleJJi H 
Q 依赖 : Web 和 JPA 
点 击 “Generate Project" ， 就 能 获得 一 个 名 为 myapp.zip 的 ZIP 文 件 。 解压 后 的 项 目 结构 同 图 1-2 
类 似 。 














= build. gradle 
src 
main 


java 
E myapp 


L— Application. java 
resources 
application.properties 
static 
templates 
test 


L— java 
i mya 


L— ApplicationTests.java 


图 1-2 ”Initializr 创 建 的 项 目 ， 提 供 了 构建 Spring Boot 应 用 程序 所 需 的 基本 内 容 


如 你 所 见 ， 项 目 里 基本 没有 代码 ， 除 了 几 个 空 目 录 外 ， 还 包含 了 如 下 几 样 东西 。 

O build.gradle: Gradle 构 建 说 明文 件 。 如 果 选 择 Maven 项 目 ， 这 就 会 换 成 pom.xml。 

口 Application.java: 一 个 带 有 main () 方 法 的 类 ， 用 于 引导 启动 应 用 程序 。 

DU ApplicationTests.java: 一 个 空 的 JUnit 测 试 类 ， 它 加 载 了 一 个 使 用 Spring Boot 自 动 
配置 功能 的 Spring 应 用 程序 上 下 文 。 

口 application.properties: 一 个 空 的 properties 文 件 ， 你 可 以 根据 需要 添加 配置 属性 。 

在 Spring Boot 应 用 程序 中 ， 就 连 空 目 录 都 有 自己 的 意义 。static 目 录放 置 的 是 Web 应 用 程序 的 



















































































静态 内 容 (JavaScript、 样 式 表 、 图 片 ， 等 等 )。 还 有 ， 稍 后 你 将 看 到 ， 用 于 呈现 模型 数据 的 模板 
会 放 在 templates 目 录 里 。 

你 很 可 能 会 把 Initializr 生 成 的 项 目 导 入 IDE。 如 果 你 用 的 IDE 是 Spring Tool Suite， 则 可 以 直接 
在 IDE 里 创建 项 目 。 下 面 来 看 看 Spring Tool Suite 是 怎么 创建 Spring Boot 项 目的 。 

2. 在 Spring Tool Suite 里 创建 Spring Boot 项 目 

KALK, Spring Tool Suite" 一直 都 是 开发 Spring 应 用 程序 的 不 二 之 选 。 从 3.4.0 版 本 开始 ， 
它 就 集成 了 Spring Initializr， 这 让 它 成 为 开始 上 手 Spring Boot 的 好 方法 。 









































(D Spring Tool Suite 是 Eclipse IDE 的 一 个 发 行 版 ,增加 了 诸多 能 辅助 Spring 开发 的 特性 。 你 可 以 从 http:/spring.io/tools/sts 
下 载 Spring Tool Suite. 
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要 在 Spring Tool Suite 里 创建 新 的 Spring Boot 应 用 程序 ， 在 File 菜 单 里 选中 New > Spring Starter 
Project 菜 单项 ， 随 后 Spring Tool Suite 会 显示 一 个 与 图 1-3 相 仿 的 对 话 框 。 

如 你 所 见 ， 这 个 对 话 框 要 求 填写 的 信息 和 Spring Initializr 的 Web 界 面 里 是 一 样 的 。 事 实 上 ， 
你 在 这 里 提供 的 数据 会 被 发 送 给 Spring Initializr， 用 于 创建 项 目 ZIP 文 件 ， 这 和 使 用 Web 表 单 是 
一 样 的 。 
























































e00 
New Spring Starter Project A 
Name 
Packaging: Jar M Java Version: 
Language: Java $ 
Group org.test 
Artifact | demo 





Description — | Demo project for Spring Boot 











Package Name | demo 








Style 
O Security 0 AOP O josc C) JPA 
口 MongoDB O Redis O Gemfire O Solr 
口 Elasticsearch C Batch C Integration 口 JMS 
口 AMQP 口 web 口 websocker Ows 
[C Rest Repositories ( ) Mobile C) Freemarker O velocity 
C Groovy Templates ( ) Thymeleaf (C) Facebook O Linkedin 
C Twitter C Actuator C Remote Shell 
© < Back ( Nex» ) [ Came ) G 


























图 1-3 Spring Tool Suite 集 成 了 Spring Initializr， 可 以 在 IDE 里 创建 并 直接 导入 Spring 
Boot 项 目 














如 果 你 想 在 文件 系统 上 指定 项 目 创建 的 位 置 , 或 者 把 它 加 入 IDE 里 的 特定 工作 集 ,就 点 击 Next 
按钮 。 你 会 看 到 第 二 个 对 话 框 ， 如 图 1-4 所 示 。 

Location 指 定 了 文件 系统 上 项 目的 存放 位 置 。 如 果 你 使 用 Eclipse 的 工作 集 来 组 织 项 目 ， 那 么 
也 可 以 勾 上 Add Project to Working Sets 这 个 复 选 框 ， 选 择 一 个 工作 集 ， 这 样 就 能 把 项 目 加 入 指定 
的 工作 集 了 。 

Site Info 部 分 简单 描述 了 将 要 用 来 访问 Initializr 的 URL, 大 多 数 情况 下 你 都 可 以 忽略 这 部 分 内 
容 。 然 而 ， 如 果 要 部 署 自 己 的 Initializr 服 务 器 (从 https:/Wgithub.com/spring-io/initializr 复 制 代码 即 
可 )， 你 可 以 在 这 里 设置 Initializr 基 础 URL 。 

点 击 Finish 按 钮 后 ， 项 目的 生成 和 导入 过 程 就 开始 了 。 你 必须 认识 到 一 点 ，Spring Tool Suite 
的 Spring Starter Project 对 话 框 ， 其 实 是 把 项 目 生 成 的 工作 委托 给 http:/startspring.io 上 的 Spring 
Initializr 来 做 的 ， 因 此 必须 联网 才能 使 用 这 一 功能 。 
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aL Ou ms —á— — -: 
New S 


pring Starter Project ana; 





a Use default location 


Location /Users/habuma/Projects/Workspaces /SpringBootlnAction /MyPro Browse 


Working sets 


C Add project to working sets 











Working sets: | m so Selectas] 
Site Info 

Base Url | http://start.spring.io/starter.zip 

Full Url http:/ /start.spring.io/starter.zip? 


groupld-org.test&artifactld -demo&name - MyProject&description - De 
mo- project for-- Spring 

* Boot&packageName - demo&packaging -jar&javaVersion- 1.7&langua 
ge-java 





© 


图 1-4 

















< Back Next > Cancel (Finish) 





Spring Starter Project 对 话 框 的 第 2 页 可 以 让 你 指定 在 哪里 创建 项 目 


且 把 项 目 导入 工作 空间 ， 应 用 程序 就 可 以 开发 了 。 在 开发 的 过 程 中 ， 你 会 发 现 Spring Tool 
Suite 针 对 Spring Boot 还 有 一 些 锦上添花 的 功能 。 比 如, 可 以 在 Run 荣 单 里 选中 Run As > Spring Boot 
Application， 在 能 入 式 服务 器 里 运行 你 的 应 用 程序 。 

注意 , Spring Tool Suite 是 通过 REST API 与 Initializr 交 互 的 , 因此 只 有 连 上 Initializr 它 才能 正常 
工作 。 如 果 你 的 开发 机 离线 , 或 者 Initializr 被 防火 墙 阻 断 了 ,那么 Spring Tool Suite 的 Spring Starter 
Project 向 导 是 无 法 使 用 的 。 

3. 在 IntelliJ IDEA 里 创建 Spring Boot 项 目 








IntelliJ IDEA 是 非 









































常 流行 的 DE，IntelliJ IDEA 14.1 已 经 支持 Spring Boot 了 ! ” 


要 在 IntelliJ IDEA 里 创建 新 的 Spring Boot 应 用 程序 ， 在 File 菜 单 里 选择 New > Project。 你 会 看 














到 几 屏 内 容 (图 1-5 是 


第 一 屏 )， 问 的 问题 和 Initializr 的 Web 应 用 程序 以 及 Spring Tool Suite 类 似 。 


在 首先 显示 的 这 一 屏 中 ， 在 左 侧 项 目 选择 里 选中 Spring Initializr ， 随 后 会 提示 你 选择 一 个 
Project SDK ( 基本 上 就 是 这 个 项 目 要 用 的 Java SDK )， 同 时 选择 Initializr Web 服 务 的 位 置 。 除 非 你 
在 使 用 自己 的 Initializr， 和 否则 应 该 不 做 任何 修改 直接 点 Next 按 钮 ， 之 后 就 到 了 图 1-6。 









































CD 你 可 以 从 https:Wwwwjetbrains.comyidea/ 获 取 IntelliJ IDEA。 它 是 一 款 商 业 IDE， 这 意味 着 你 需要 付费 使 用 。 但 是 你 
可 以 下 载 试用 版 ， 它 对 开源 项 目 免费 。 
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eoo New Project 
Eä Java Project SDK: ( 21.8 (java version "1.8.0. 31") $] (New... ) 
Ki Java Enterprise PEN. " 
Și Android Enter/select Initializr Service URL. 
nitializr Service URL: — |https://start.spring.io " 
($8 J2ME Initializr Service URL: — https:// ing.i 
Q Clouds Make sure your network connection is active before continuing. 
Ø Spring 
Eà Java FX 








5f Intellij Platform Plugin 





| m Maven 
© Gradle 
© Groovy 
€ Griffon 
€? Grails 
Q Static Web 
(9 Node.js and NPM 
Ez Flash 
E3 Empty Project 


© (revos) (NE 

















图 1-5 IntelliJ IDEA Œ Spring Boot 初 始 化 向 导 的 第 一 屏 





























eoe New Project 
Name: demo 
Type: Maven Project (Generate a Maven based project archive) + 
Packaging: Jar $ 
Java Version: ds mai 
Language: Java t 
Group: org.test 
Artifact: demo 
Version: 0.0.1- SNAPSHOT 
Description: |Demo project for Spring Boot 
Package: demo 














@ [cancer | 








图 1-6 在 IntelliJ IDEA 的 Spring Boot 初 始 化 向 导 里 指定 项 目 信 息 
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Spring Boot 初 始 化 向 导 的 第 二 屏 要 求 你 提供 项 目的 一 些 基本 信息 ， 比 如 项 目 名 称 、Maven 
Group 和 Artifact、jJava 版 本 ， 以 及 你 是 想 用 Maven 还 是 Gradle 来 构建 项 目 。 描 述 好 项 目 信 息 之 后 ， 
点 击 Next 按 钮 就 能 看 到 第 三 屏 了 ， 如 图 1-7 所 示 。 


e50 New Project 





























Spring Boot Version: | 1.2.3 £j 


Dependencies 


Y Core 














C) Security O AOP 
* Web 
C] Web C Websocket ws C) Vaadin 
C) Rest Repositories C Mobile 
» Template Engines 
C) Freemarker O Velocity C) Groovy Templates C Thymeleaf 
¥ Data 
(_] JDBC LJ JPA L MongoDB [_] Redis 
C) Gemfire O Solr (C) Elasticsearch 
*» Cloud 
» Database 
C H2 C) HSQLDB C) MySQL C) PostgreSQL 
* Social 
[.] Facebook [.) LinkedIn ( ] Twitter 
"VO 
口 Batch C Integration C JMS C AMQP 
* Ops 
C) Actuator C) Remote Shell 
D m ET 一 








图 1-7 在 mtelliJIDEA 的 Spring Boot 初 始 化 向 导 里 选择 项 目 依 赖 


第 二 屏 向 你 询问 项 目的 基本 信息 , 第 三 屏 就 开始 问 你 要 往 项 目 里 添加 什么 依赖 了 。 和 之 前 一 
FE, 屏幕 里 的 复 选 框 和 Spring Boot 起 步 依赖 是 对 应 的 。 选 完 之 后 点 击 Next 就 到 了 向 导 的 最 后 一 屏 ， 
如 图 1-8 所 示 。 

最 后 一 屏 问 你 项 目 叫 什么 名 字 ， 还 有 要 在 哪里 创建 项 目 。 一 切 准备 就 绪 之 后 ， 点 击 Finish 按 
钮 ， 就 能 在 IDE 里 得 到 一 个 空 的 Spring Boot 项 目 了 。 
4. 在 Spring Boot CLI 里 使 用 Initializr 
如 前 文 所 述 ， 如 果 你 想 仅 仅 写 代码 就 完成 Spring 应 用 程序 的 开发 ， 那 么 Spring Boot CLI 是 个 
不 错 的 选择 。 然 而 ，Spring Boot CLI 的 功能 还 不 限于 此 ， 它 有 一 些 命令 可 以 帮 你 使 用 Initializr， 通 
它 上 手 开 发 更 传统 的 Java 项 目 。 

Spring Boot CLI 包 含 了 一 个 init 命 令 ， 可 以 作为 Initializr 的 客户 端 界面 。init 命 令 最 简单 的 
用 法 就 是 创建 Spring Boot 项 目的 基线 : 


$ spring init 


























过 
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(ESR) New Project 





Project name: demo 








Project location: |~/IdeaProjects/demo 














> More Settings 
(2 Cancel | | Previous [Finish] 





á 








图 1-8 Intellij IDEA} Spring Boot 初 始 化 向 导 的 最 后 一 屏 


在 和 Initializr 的 Web 应 用 程序 通信 后 ，init 命 令 会 下 载 一 个 demo.zip 文 件 。 解 压 后 你 会 看 到 
一 个 典型 的 项 目 结构 , 包含 一 个 Maven 的 pom.xml 构 建 描述 文件 。Maven 的 构建 说 明 只 包含 最 基本 
的 内 容 ， 即 只 有 Spring Boot 基 线 和 测试 起 步 依 赖 。 你 可 能 会 想 要 更 多 的 东西 。 

假设 你 想 要 构建 一 个 web 应 用 程序 ， 其 中 使 用 JPA 实 现 数据 持久 化 ， 使 用 Spring Security 进 行 
安全 加 固 ， 可 以 用 --dependencies 或 -gd 来 指定 那些 初始 依赖 : 

$ spring init -dweb,jpa,security 

这 条 命令 会 下 载 一 个 demo.zip 文 件 ， 包 含 与 之 前 一 样 的 项 目 结构 ， 但 在 pom.xml 里 增加 了 
Spring Boot 的 Web、jpa 和 security 起 步 依 赖 。 请 注意 ， 在 -a 和 依赖 之 间 不 能 加 空格 ， 否 则 就 变 成 
了 下 载 一 个 ZIP 文 件 ， 文 件 名 是 web,jpa,security。 

现在 ,假设 你 想 用 Gradle 来 构建 项 目 。 没 问题 ， 用 --pbuilgd 参 数 将 Gradle 指 定 为 构建 类 型 . 


$ spring init -dweb,jpa,security --build gradle 


默认 情况 下 ， 无 论 是 Maven 还 是 Gradle 的 构建 说 明 都 会 产生 一 个 可 执行 JAR 文 件 。 但 如 果 你 
想 要 一 个 WAR 文 件 ， 那 么 可 以 通过 --packaging 或 者 -p 参 数 进行 说 明 : 
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$ spring init -dweb,jpa,security --build gradle -p war 


到 目前 为 止 ，init 命 令 只 用 来 下 载 ZIP 文 件 。 如 果 你 想 让 CLI 帮 你 解压 那个 ZIP 文 件 ， 可 以 指 
定 一 个 用 于 解压 的 目录 : 


$ spring init -dweb,jpa,security --build gradle -p war myapp 


此 处 的 最 后 一 个 参数 说 明 你 希望 把 项 目 解压 到 myapp 目 录 里 去 。 
此 外 ， 如 果 你 希望 CLI 把 生成 的 项 目 解 压 到 当前 目录 ， 可 以 使 用 --extract 或 者 -x 参 数 : 


$ spring init -dweb,jpa,security --build gradle -p jar -x 


init 命 令 还 有 不 少 其 他 参数 ,包括 基于 Groovy 构 建 项 目的 参数 .指定 用 Java 版 本 编译 的 参数 ， 
还 有 选择 构建 依赖 的 Spring Boot 版 本 的 参数 。 可 以 通过 help 命 令 了 解 所 有 参数 的 情况 : 

$ spring help init 

你 也 可 以 查看 那些 参数 都 有 哪些 可 选项 ， 为 init 命 令 带 上 --1ist 或 -1 参数 就 可 以 了 : 

$ spring init -1 

你 一 定 注 意 到 了 ， 尽 管 spring init -1l 列 出 了 一 些 Initializr 支 持 的 参数 ， 但 并 非 所 有 参数 
都 能 直接 为 Spring Boot CLI 的 init 命 令 所 支持 。 举 例 来 说 ， 用 CLI 初 始 化 项 目 时 ， 你 不 能 指定 根 
包 的 名 字 ， 它 默认 为 demo。spring help init 会 告诉 你 CLI 的 init 命 令 都 支持 哪些 参数 。 

无 论 你 是 用 Initializr 的 Web 界 面 ， 在 Spring Tool Suite 里 创建 项 目 ， 还 是 用 Spring Boot CLI 来 初 
始 化 项 目 ，Spring Boot Initializr 创 建 出 来 的 项 目 都 有 相似 的 项 目 布局 ， 和 你 之 前 开发 过 的 Java 项 
目 没 什么 不 同 。 
















































































1.3 小 结 


Spring Boot 为 Spring 应 用 程序 的 开发 提供 了 一 种 激动 人 心 的 新 方式 ， 框 架 本 身 带 来 的 阻力 很 
小 。 自 动 配置 消除 了 传统 Spring 应 用 程序 里 的 很 多 样板 配置 ; Spring Boot 起 步 依 赖 让 你 能 通过 库 
所 提供 的 功能 而 非 名 称 与 版 本 号 来 指定 构建 依赖 ，Spring Boot CLE Spring Boot 的 无 阻碍 开发 模 
型 提升 到 了 一 个 绒 新 的 高 度 ， 在 命令 行 里 就 能 简单 快速 地 用 Groovy 进 行 开 发 ; Actuator 让 你 能 深 
入 运行 中 的 应 用 程序 ， 了 人 解 Spring Boot 做 了 什么 ， 是 怎么 做 的 。 

本 章 大 致 概括 了 Spring Boot 的 功能 。 你 大 概 已 经 跃跃欲试 ， 想 用 Spring Boot 来 写 个 真实 的 应 
用 程序 了 吧 。 这 正 是 我 们 在 下 一 章 里 要 做 的 事情 。 有 了 Spring Boot 提 供 的 诸多 功能 ， 最 困难 的 不 
过 是 把 书 翻 到 第 2 章 。 





























开发 第 一 个 应 用 程序 








本 章 内 容 
口 使 用 Spring Boot 起 步 依赖 
口 自动 进行 Spring 配置 


























你 上 次 在 超市 或 大 型 零售 商店 自己 推 开门 是 什么 时 候 ? 大 多 数 大 型 商店 都 安装 了 人 带 感 应 功 
能 的 自动 门 ， 虽 然 所 有 门 都 能 让 你 进入 建筑 物 内 ， 但 自动 门 不 用 你 动手 推拉 。 

与 之 类 似 , 很 多 公共 场所 的 卫生 间 里 都 装 有 自动 感应 水 龙头 和 自动 感应 纸巾 机 。 虽 然 没 有 超 
市 自动 门 这 么 普及 ， 但 这 些 设施 同样 对 你 没有 太 多 要 求 ， 可 以 很 方便 地 出 水 和 纸巾 。 

说 实话 , 我 已 经 不 记得 上 次 看 到 制 冰 盒 是 什么 时 候 了 , 更 不 记得 自己 往 里 面倒 水 制 冰 或 者 取 
冰 的 事 了 。 我 的 冰箱 就 是 这 么 神奇 ， 总 是 有 冰 ， 让 我 随时 都 能 喝 上 冰 水 。 

我 敢 打赌 你 也 能 想 出 无 数 例子 , 证 明 设备 让 现代 生活 更 加 自动 化 , 而 不 是 增加 障碍 。 有 了 这 些 
自动 化 的 便利 设施 ， 你 会 认为 在 开发 任务 里 也 会 出 现 更 多 的 自动 化 。 但 是 很 奇怪 ,事实 并 非 如 此 。 

直到 最 近 ， 要 用 Spring 创建 应 用 程序 ， 你 还 需要 为 框架 做 很 多 事情 。 当 然 ，Spring 提 供 了 很 
多 优秀 的 特性 ， 用 于 开发 令 人 惊讶 的 应 用 程序 。 但是, 你 需要 自己 往 项 目的 构建 说 明文 件 里 添加 
各 种 库 依赖 ， 还 要 自己 写 配 置 文件 ， 告 诉 Spring 要 做 什么 。 

Spring Boot 将 Spring 开 发 的 自动 化 程度 提升 到 了 一 个 新 的 高 度 ， 在 本 章 我 们 会 看 到 两 种 新 方 
法 : 起 步 依赖 和 自动 配置 。 在 项 目 中 启用 Spring 不 仅 枯 燥 乏 味 ， 还 让 人 分 神 ， 你 将 看 到 这 些 基础 
的 Spring Boot 特 性 是 如 何 将 你 解放 出 来 ， 让 你 集中 精力 开发 应 用 程序 的 。 与 此 同时 ， 你 会 写 一 个 
很 小 的 Spring 应 用 程序 ， 麻 淮 虽 小 ， 五 脏 俱全 ， 其 中 会 用 上 Spring Boot; 






































































































































2.1 运用 Spring Boot 


你 正在 阅读 本 书 ， 说 明 你 是 一 位 读书 人 。 也 许 你 是 一 个 书 虫 ,博览 群 书 ; 也 许 你 只 读 自 己 需 
要 的 东西 ， 拿 起 本 书 只 是 为 了 知道 怎么 用 Spring 开发 应 用 程序 。 

无 论 何 种 情况 ,你 都 是 一 位 读书 人 , 是 读书 人 便 有 心 维护 一 个 阅读 列表 ,里 面 是 自己 想 读 或 
者 需要 读 的 书 。 就 算 没有 白 纸 黑 字 的 列表 ， 至 少 在 你 心里 会 有 这 么 一 个 列表 。” 
























































CD 如果 你 不 是 一 个 读书 人 ， 就 把 书 换 成 想 看 的 电影 、 想 去 的 餐厅 ， 只 要 合适 自己 就 好 。 
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在 本 书 中 , 我 们 会 构建 一 个 简单 的 阅读 列表 应 用 程序 。 在 这 个 程序 里 , 用 户 可 以 输入 想 读 的 
图 书信 息 ， 查 看 列表 ,删除 已 经 读 过 的 书 。 我 们 将 使 用 Spring Booc A BIEGSROT AZ, 4E RRER CAS: 





节 越 少 越 好 。 


开始 前 ,我 们 需要 先 初始 化 一 个 项 目 。 在 第 1 章 里 ,我 们 看 到 了 好 几 种 从 Spring Initializr 开 始 
Spring Boot 开 发 的 方法 。 因 为 选择 哪 种 方法 都 行 ， 所 以 要 选 个 最 合适 的 ， 着 手 用 Spring Boot 开 发 


就 好 了 。 


从 技术 角度 来 看 ， 我 们 要 用 Spring MVC 来 处 理 Web 请 求 ， 用 Thymeleaf 来 定义 Web 视 图 ， 用 
Spring Data JPA 来 把 阅读 列表 持久 化 到 数据 库 里 ， 嬉 且 先 用 航 入 式 的 H2 数 据 库 。 虽 然 也 可 以 用 
Groovy， 但 是 我 们 还 是 先 用 Java 来 开发 这 个 应 用 程序 吧 。 此 外 ， 我 们 使 用 Gradle 作 为 构建 工具 。 

无 论 是 用 Web 界 面 、Spring Tool Suite 还 是 IntelliJ IDEA， 只 要 用 了 Initializr， 你 就 要 确保 勾 选 
了 Web 、Thymeleaf 和 JPA 这 几 个 复 选 框 。 还 要 记得 勾 上 H2 复 选 框 ， 这 样 才 能 在 开发 应 用 程序 时 使 














用 这 个 内 嵌 式 数据 库 。 





至 于 项 目 元 信息 ， 就 随便 你 写 了 。 以 阅读 列表 为 例 ， 我 创建 项 目 时 使 月 


eoe < m * 









































& start.spring.io © th 句 


Spring Initializr + 


SPRING INITIALIZR 





Generate a [edeProiect «| with Spring Boot |:3osc: 


Project Metadata 
Artifact coordinates 
Group 

com.manning 
Artifact 

xeadinglist 
Name 

Reading List 
Description 

Reading List Demo 
Package Name 

xeadinglist 
Packaging 

Jar 
Java Version 

18 
Language 


Java 


Too many options? Switch back to the simple version. 


Generate Project * + « 


图 2-1 通过 Initializr 的 Web 界 面 初始 化 阅读 列表 应 用 程序 





Dependencies 
Add Spring Boot Starters and dependencies to your application 
Search for dependencies 


Bg Web, Security, JPA, Actuator, Devtools... 


Selected Starters 


Brura 























日 了 图 2-1 中 的 信息 。 
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如 果 你 创建 项 目 时 用 的 是 Spring Tool Suite 或 者 Intellij IDEA， 那 么 把 图 2-1 的 内 容 适 配 成 IDE 
需要 的 东西 就 好 了 。 

另 一 方面 ， 如 果 用 Spring Boot CLI 来 初始 化 应 用 程序 ， 可 以 在 命令 行 里 键入 以 下 内 容 : 

$ spring init -dweb,data-jpa,h2,thymeleaf --build gradle readinglist 


请 记 住 ，CLI 的 init 命 令 是 不 能 指定 项 目 根 包 名 和 项 目 名 的 。 包 名 默认 是 demo, 项 目 名 默认 
是 Demo 。 在 项 目 创建 完毕 之 后 ， 你 可 以 打开 项 目 ， 把 包 名 demo 改 为 readinglist ， 把 
DemoApplication.java 改 名 为 ReadingListApplication.java。 


项 目 创建 完毕 后 ， 你 应 该 能 看 到 一 个 类 似 图 2-2 的 项 目 结构 。 










































































readinglist 
build.gradle 
src 
main 


C 
readinglist 
ReadingListApplication.java 
resources 
application.properties 
static 
templates 
test 


E 
readinglist 
ReadingListApplicationTests. java 


图 2-2 ”初始 化 后 的 readinglist 项 目 结构 

















这 个 项 目 结构 基本 上 和 第 1 章 里 Initializr 生 成 的 结构 是 一 样 的 , 只 不 过 你 现在 真 的 要 去 开发 应 
用 程序 了 ， 所 以 让 我 们 先 放 慢 脚步 ， 仔 细 看 看 初始 化 的 项 目 里 都 有 什么 东西 。 








2.1.1 查看 初始 化 的 Spring Boot 新 项 目 


图 2-2 中 值得 注意 的 第 一 件 事 是 ， 整 个 项 目 结构 遵循 传统 Maven 或 Gradle 项 目的 布局 ， 即 主要 
应 用 程序 代码 位 于 src/main/java 目 录 里 ， 资 源 都 在 src/main/resources 目 录 里 ， 测试 代 码 则 在 
src/test/java 目 录 里 。 此 刻 还 没有 测试 资源 ， 但 如 果 有 的 话 ， 要 放 在 sre/test/resources 里 。 
再 进一步 ， 你 会 看 到 项 目 里 还 有 不 少 文件 。 
口 build.gradle: Gradle 构 建 说 明文 件 。 
口 ReadingListApplication.java: 应 用 程序 的 启 动 引 导 类 ( bootstrap class ), 也 是 主要 
的 Spring 配置 类 。 
口 application.properties: 用 于 配置 应 用 程序 和 Spring Boot 的 属性 。 
D ReadingListApplicationTests.java: 一 个 基本 的 集成 测试 类 。 
因为 构建 说 明文 件 里 有 很 多 Spring Boot 的 优点 尚未 揭秘 ， 所 以 我 打算 把 最 好 的 留 到 最 后 ， 先 
让 我 们 来 看 看 ReadingListApplication.java。 

































































22 XoiX 开发 第 一 个 应 用 程序 








1. 启动 引导 Spring 
ReadingListApplication 在 Spring Boot 应 用 程序 里 有 两 个 作用 : 配置 和 启动 引导 。 首 先 ， 























这 是 主要 的 Spring 配置 类 。 虽 然 Spring Boot 的 自动 配置 免除 了 很 多 Spring 配置 ， 但 你 还 需要 进行 











少量 配置 来 启用 自动 配置 。 正 如 代码 清单 2-1 所 示 ， 这 里 只 有 一 行 配置 代码 。 
代码 清单 2-1 ReadingListaApplication.java 不 仅 是 局 动 引导 类 ， 还 是 配置 类 


解 ， 





package readinglist; 


import org.springframework.boot.SpringApplication; 
import org.springframework.boot.autoconfigure.SpringBootApplication; 


GSpringBootApplication = 地 开启 组 件 扫描 和 
public class ReadingListApplication ( 自动 配置 


public static void main(String[] args) ( 
SpringApplication.run(ReadingListApplication.class, args); 负责 启动 引导 应 


) 用 程序 
j 


espringBootaApplication 开 启 了 Spring 的 组 件 扫描 和 Spring Boot 的 自动 配置 功能 。 实 际 

@SpringBootApplication 将 三 个 有 用 的 注解 组 合 在 了 一 起 。 

Q SpringffjeConfiguration: 标明 该 类 使 用 Spring 基于 Java 的 配置 。 虽 然 本 书 不 会 写 太 多 

配置 ， 但 我 们 会 更 倾向 于 使 用 基于 Java 而 不 是 XML 的 配置 。 

口 Spring 的 ecomponentScan: 局 用 组 件 扫描 ， 这 样 你 写 的 Web 控 制 锅 类 和 其 他 组 件 才 能 和 
自动 发 现 并 注册 为 Spring 应 用 程序 上 下 文 里 的 Bean。 本 章 稍 后 会 写 一 个 简单 的 Spring MVC 
控制 器 ， 使 用 econtrollez 进 行 注解 ， 这 样 组 件 扫描 才能 找到 它 。 

O Spring Boot 的 enableaAutoconfiguration : 这 个 不 起 眼 的 小 注解 也 可 以 称 为 
eaAbracadabrau ， 就 是 这 一 行 配置 开启 了 Spring Boot 自 动 配置 的 魔力 ， 让 你 不 用 再 写成 
篇 的 配置 了 。 

在 Spring Boot 的 早期 版 本 中 ， 你 需要 在 ReadingListApplication 类 上 同时 标 上 这 三 个 注 

但 从 Spring Boot 1.2.0 开 始 ， 有 @SpringBootApplication 就 行 了 。 

如 我 所 说 ，ReadingListApplication 还 是 一 个 启动 引导 类 。 要 运行 Spring Boot 应 用 程序 






























































有 几 种 方式 ， 其 中 包含 传统 的 WAR 文 件 部 署 。 但 这 里 的 main () 方 法 让 你 可 以 在 命令 行 里 把 该 应 
用 程序 当 作 一 个 可 执行 JAR 文 件 来 运行 。 这 里 向 springApplication.run() 传 递 了 一 个 
ReadingListApplication 类 的 引用 ， 还 有 命令 行 参 数 ， 通 过 这 些 东西 启动 应 用 程序 。 


序 ， 

















实际 上 ， 就 算 一 行 代 码 也 没 写 ， 此 时 你 仍然 可 以 构建 应 用 程序 党 尝鲜 。 要 构建 并 运行 应 用 程 
最 简单 的 方法 就 是 用 Gradle 的 bootRun 任 务 : 


$ gradle bootRun 























(D abracadabra 的 意思 是 咒语 。 一 一 译 者 注 
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bootRun 任 务 来 自 Spring Boot 的 Gradle 搬 件 ， 我 们 会 在 2.1.2 节 里 详细 讨论 。 此 外 ， 你 也 可 以 
用 Gradle 构 建 项 目 ， 然 后 在 命令 行 里 用 java 来 运行 它 : 


$ gradle build 


8 java -jar build/libs/readinglist-0.0.1-SNAPSHOT.jar 

应 用 程序 应 该 能 正常 运行 ,启动 一 个 监听 8080 端 口 的 Tomcat 服 务 器 。 要 是 愿意 ,你 可 以 用 浏 
览 器 访问 http://localhost:8080, 但 由 于 还 没 写 控制 器 类 , 你 只 会 收 到 一 个 HTTP 404( NOTFOUND ) 2 
错误 ， 看 到 错误 页 面 。 在 本 章 结束 前 ， 这 个 URL 将 会 提供 一 个 阅读 列表 应 用 程序 。 

你 几乎 不 需要 修改 ReadingListApplication.java。 如 果 你 的 应 用 程序 需要 Spring Boot 
自动 配置 以 外 的 其 他 Spring 配 置 ， 一 般 来 说 ， 最 好 把 它 写 到 一 个 单独 的 econfiguration 标 注 的 
类 里 。( 组 件 扫 描 会 发 现 并 使 用 这 些 类 的 。) 极度 简单 的 情况 下 ， 可 以 把 自 定义 配置 加 入 
ReadingListApplication.javao 

2. 测试 Spring Boot 应 用 程序 

Initializr 还 提供 了 一 个 测试 类 的 骨架 ， 可 以 基于 它 为 你 的 应 用 程序 编写 测试 。 但 
ReadingListApplicationTests (代码 清单 2-2 ) 不 止 是 个 用 于 测试 的 占 位 符 ， 它 还 是 一 个 例 
子 ， 告 诉 你 如 何 为 Spring Boot 应 用 程序 编写 测试 。 












































代码 清单 2-2 espringapplicationconfioguration 加 载 Spring 应 用 程序 上 下 文 
package readinglist; 
import org.junit.Test; 
import org.junit.runner.RunWith; 
import org.springframework.boot.test.SpringApplicationConfiguration; 


import org.springframework.test.context.junit4.SpringJUnit4ClassRunner; 
import org.springframework.test.context.web.WebAppConfiguration; 


import readinglist.ReadingListApplication; 


QGRunWith(SpringJUnit4ClassRunner.class) 


GSpringApplicationConfiguration( 通过 spring Boot 
classes = ReadingListApplication.class) «—— 加 载 上 下 文 
@WebAppConfiguration 


public class ReadingListApplicationTests { 


@Test 测试 加 载 的 上 下 文 
public void contextLoads() { < 
} 

} 

一 个 典型 的 Spring 集 成 测试 会 用 &contextCconfiguration 注 解 标 识 如 何 加 载 Spring 的 应 用 
程序 上 下 文 。 但 是 ， 为 了 充分 发 挥 Spring Boot 的 魔力 ， 这 里 应 该 用 @SpringApplication- 
Configurationitfff, 正如 你 在 代码 清单 2-2 里 看 到 的 那样 ， ReadingListApplicationTests 
使 用 @sSpringApplicationCconfiguration 注 解 从 ReadingListApplication 配 置 类 里 加 载 
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Spring 应 用 程序 上 下 文 。 

ReadingListApplicationTests 里 还 有 一 个 简单 的 测试 方法 ， 即 contextLoads () 。 实 
际 上 它 就 是 个 空 方 法 。 但 这 个 空 方法 足以 证 明 应 用 程序 上 下 文 的 加 载 没 有 问题 。 如 果 
ReadingListApplication 里 定义 的 配置 是 好 的 ,就 能 通过 测试 。 如 果 有 问题 , 测试 就 会 失败 。 

MUR, 现在 这 只 是 一 个 新 的 应 用 程序 ， 你 还 会 添加 自己 的 测试 。 但 contextLoags () 方 法 是 
个 良好 的 开端 ， 此 刻 可 以 验证 应 用 程序 提供 的 各 种 功能 。 第 4 章 会 更 详细 地 讨论 如 何 测试 Spring 
Boot 应 用 程序 。 

3. 配置 应 用 程序 属性 

Initializr 为 你 生成 的 application.properties 文 件 是 一 个 空 文件 .实际 上 ,这 个 文件 完全 是 可 选 的 ， 
你 大 可 以 删 掉 它 ， 这 不 会 对 应 用 程序 有 任何 影响 ， 但 留 着 也 没什么 问题 。 

稍 后 , 我 们 肯定 有 机 会 向 application.properties 里 添加 几 个 条 目 。 但 现在 , 如 果 你 想 小 试 牛刀 ， 
可 以 加 一 行 看 看 : 

server.port=8000 


加 上 这 一 行 , 租 入 式 Tomcat 的 监听 端口 就 变 成 了 8000， 而 不 是 默认 的 8080。 你 可 以 重新 运行 
应 用 程序 ， 看 看 是 不 是 这 样 。 

这 说 明 application.properties 文 件 可 以 很 方便 地 帮 你 细 粒 度 地 调整 Spring Boot 的 自动 配置 。 你 
还 可 以 用 它 来 指定 应 用 程序 代码 所 需 的 配置 项 。 在 第 3 章 里 我 们 会 看 到 好 几 个 例子 ， 演 示 
application.properties 的 这 两 种 用 法 。 

要 注意 的 是 ， 你 完全 不 用 告诉 Spring Boot 为 你 加 载 application.properties， 只 要 它 存 
在 就 会 被 加 载 ，Spring 和 应 用 程序 代码 都 能 获取 其 中 的 属性 。 

我 们 差不多 已 经 把 初始 化 的 项 目 介绍 完了 ， 还 剩 最 后 一 样 东 西 ， 让 我 们 来 看 看 Spring Boot 
应 用 程序 是 如 何 构建 的 。 



















































































2.1.2. Spring Boot 项 目 构建 过 程 解析 


Spring Boot 应 用 程序 的 大 部 分 内 容 都 与 其 他 Spring 应 用 程序 没有 什么 区 别 ， 与 其 他 Java 应 用 
程序 也 没什么 两 样 ， 因 此 构建 一 个 Spring Boot 应 用 程序 和 构建 其 他 Java 应 用 程序 的 过 程 类 似 。 你 
可 以 选择 Gradle 或 Maven 作 为 构建 工具 ， 描 述 构建 说 明文 件 的 方法 和 描述 非 Spring Boot 应 用 程序 
的 方法 相似 。 但 是 ，Spring Boot 在 构建 过 程 中 页 了 些小 把 戏 ， 在 此 需要 做 个 小 小 的 说 明 。 

Spring Boot 为 Gradle 和 Maven 提 供 了 构建 插件 ， 以 便 辅 助 构建 Spring Boot 项 目 。 代 码 清 单 2-3 
是 Initializr 创 建 的 build.gradle 文 件 ， 其 中 应 用 了 Spring Boot 的 Gradle 插 件 。 


代码 清单 2-3 ”使 用 Spring Boot 的 Gradle 插 件 
buildscript ( 
ext ( 
springBootVersion = '1.3.0.RELEASE' 
j 


repositories ( 
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mavenCentral() 
} Ik dfi Spring 
dependencies { Boot 插 件 
classpath("org.springframework.boot:spring-boot-gradle-plugin: < 一 
s{springBootVersion}") 


apply plugin: 'java' 
apply plugin: 'eclipse' 
apply plugin: 'idea' 
apply plugin: 'spring-boot' a 插件 





运用 spring Boot 


jar ( 
baseName - 'readinglist' 
version - '0.0.1-SNAPSHOT' 

} 

sourceCompatibility = 

targetCompatibility 


Hog 
eHe 
a n 


repositories { 
mavenCentral() 


起 步 依 赖 


dependencies ( 
compile("org.springframework.boot:spring-boot-starter-web") < 一 一 
compile("org.springframework.boot:spring-boot-starter-data-jpa") 
compile("org.springframework.boot:spring-boot-starter-thymeleaf") 
runtime("com.h2database:h2") 
testCompile("org.springframework.boot:spring-boot-starter-test") 


eclipse ( 
classpath { 
containers.remove('org.eclipse.jdt.launching.JRE CONTAINER !') 
containers 'org.eclipse.jdt.launching.JRE CONTAINER/org.eclipse.jdt.internal. 
debug.ui.launcher.StandardVMType/JavaSE-1.7' 


task wrapper (type: Wrapper) ( 
gradleVersion = '1.12' 


} 


男 一 方面 ， 要 是 选择 用 Maven 来 构建 应 用 程序 ，Initializr 会 蔡 你 生成 一 个 pom.xml 文 件 ， 其 中 
使 用 了 Spring Boot 的 Maven 插 件 ， 如 代码 清单 2-4 所 示 。 


代码 清单 2-4 使 用 Spring Boot 的 Maven 插 件 及 父 起 步 依 赖 


«?xml version-"1.0" encoding="UTF-8"?> 

«project xmlns-"http://maven.apache.org/POM/4.0.0" 
xmlns:xsi-"http://www.w3.0org/2001/XMLSchema-instance" 
xsi:schemaLocation-"http://maven.apache.org/POM/4.0.0 
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http://maven.apache.org/xsd/maven-4.0.0.xsd"» 
«modelVersion»4.0.0«/modelVersion» 


«groupId»com.manning«/groupId» 
«artifactId»readinglist«/artifactId» 
«version»0.0.1-SNAPSHOT«/version» 
«packaging»jar«/packaging» 


«name»ReadingList«/name» 


«description»Reading List Demo«/description» , 
B 2 E 从 spring-boot-starter- 


parent 继 承 版 本 号 


<parent> 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-parent«/artifactId» 
«version»(springBootVersion)«/version» 


«relativePath/» «!-- lookup parent from repository --» 
«/parent» 
«dependencies» < 二 一 
«dependency» 起 步 依 赖 


<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-web</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
«artifactId»spring-boot-starter-data-jpa«/artifactId» 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-thymeleaf</artifactId> 

</dependency> 

<dependency> 
<groupId>com.h2database</groupId> 
<artifactId>h2</artifactId> 

</dependency> 

<dependency> 
<groupId>org.springframework.boot</groupId> 
«artifactId»spring-boot-starter-test«/artifactId» 
«scope»test«/scope» 

</dependency> 

</dependencies> 


<properties> 
«project.build.sourceEncoding» 
UTF-8 
«/project.build.sourceEncoding» 
«start-class»readinglist.Application«/start-class» 
«java.version»1.7«/java.version» 
«/properties» 


«build» 


运用 Spring Boot 插 件 
«plugins» 
«plugin» 
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«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-maven-plugin«/artifactId» 
«/plugin» 
«/plugins» 
«/build» 


«/project» 


无 论 你 选择 Gradle 还 是 Maven，Spring Boot 的 构建 搬 件 都 对 构建 过 程 有 所 帮助 。 你 已 经 看 到 
过 如 何 用 Gradle 的 bootRun 任 务 来 运行 应 用 程序 了 。Spring Boot 的 Maven 搬 件 与 之 类 似 ， 提 供 了 
一 个 spring-boot :run 目 标 ， 如 果 你 使 用 Maven， 它 能 实现 相同 的 功能 。 

构建 插件 的 主要 功能 是 把 项 目 打包 成 一 个 可 执行 的 超级 JAR ( uber-JAR ), 包括 把 应 用 程序 的 
所 有 依赖 打 入 JAR 文 件 内 ， 并 为 JAR 添 加 一 个 描述 文件 ， 其 中 的 内 容 能 让 你 用 java -jar 来 运行 
应 用 程序 。 

除了 构建 插件 , 代码 清单 2-4 里 的 Maven 构 建 说 明 中 还 将 spring-boot-starter-parent 作 为 上 一 级 ， 
这 样 一 来 就 能 利用 Maven 的 依赖 管理 功能 ， 继 承 很 多 常用 库 的 依赖 版 本 ， 在 你 声明 依赖 时 就 不 用 
再 去 指定 版 本 号 了 。 请 注意 ， 这 个 pom.xml 里 的 <aepenaency> 都 没有 指定 版 本 。 

遗憾 的 是 ，Gradle 并 没有 Maven 这 样 的 依赖 管理 功能 ， 为 此 Spring Boot Gradle 搬 件 提供 了 第 
三 个 特性 ， 它 为 很 多 常用 的 Spring 及 其 相关 依赖 模拟 了 依赖 管理 功能 。 其 结果 就 是 ,代码 清单 2-3 
的 build.gradle 里 也 没有 为 各 项 依赖 指定 版 本 。 

说 起 依赖 ， 无 论 哪 个 构建 说 明文 件 ， 都 只 有 五 个 依赖 ， 除 了 你 手工 添加 的 H2 之 外 ， 其 他 的 
Artifact ID 都 有 spring-boot-starter- 前 级 。 这 些 都 是 Spring Boot 起 步 依赖 ， 它 们 都 有 助 于 
Spring Boot 应 用 程序 的 构建 。 让 我 们 来 看 看 它们 究竟 都 有 哪些 好 处 。 


2.2 ”使 用 起 步 依赖 


要 理解 Spring Boot 起 步 依 赖 带 来 的 好 处 ， 先 让 我 们 假设 它们 尚 不 存在 。 如 果 没 用 Spring Boot 
的 话 ， 你 会 向 项 目 里 添加 哪些 依赖 呢 ? 要 用 Spring MVC 的 话 ， 你 需要 哪个 Spring 依赖 ? 你 还 记得 
Thymeleaf 的 Group 和 Artifact IDH? 你 应 该 用 哪个 版 本 的 Spring Data JPA 呢 ? 它们 放 在 一 起 兼容 
吗 ? 

看 来 如 果 没 有 Spring Boot 起 步 依赖 ， 你 就 有 不 少 功课 要 做 。 而 你 想 要 做 的 只 不 过 是 开发 一 个 
Spring Web 应 用 程序 ， 使 用 Thymeleaf 视 图 ， 通 过 JPA 进 行 数据 持久 化 。 但 在 开始 编写 第 一 行 代码 
之 前 ， 你 得 搞 明 白 ， 要 支持 你 的 计划 ， 需 要 往 构 建 说 明 里 加 入 哪些 东西 。 

考虑 再 三 之 后 〈 也 许 你 还 从 其 他 有 相似 依赖 的 应 用 程序 构建 说 明 中 复制 粘贴 了 不 少 内 容 )， 
你 的 Gradle 构 建 说 明 里 大 概 会 有 下 面 这 些 东 西 : 
























































































































































("org.springframework:spring-web:4.1.6.RELEASE") 

("org.thymeleaf:thymeleaf-spring4:2.1.4.RELEASE") 

compile("org.springframework.data:spring-data-jpa:1.8.0.RELEASE") 
("org.hibernate:hibernate-entitymanager:jar:4.3.8.Final") 
("com.h2database:h2:1.4.187") 
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这 段 依赖 列表 不 错 , 应 该 能 正常 工作 , 但 你 是 怎么 知道 的 ?你 怎么 保证 你 选 的 这 些 版 本 能 相 
互 兼容 ? 也 许可 以 , 但 构建 并 运行 应 用 程序 之 前 你 是 不 知道 的 。 再 说 了 ,你 怎么 知道 这 个 列表 是 
完整 的 ? 在 一 行 代码 都 没 写 的 情况 下 ， 你 离开 始 构建 还 有 很 长 的 路 要 走 。 

让 我 们 退 一 步 再 想 想 ， 我 们 要 做 什么 。 我 们 要 构建 一 个 拥有 如 下 功能 的 应 用 程序 。 

口 这 是 一 个 Web 应 用 程序 。 
O 它 用 了 Thymeleaf。 
O 它 通过 Spring Data JPA 在 关系 型 数据 库 里 持久 化 数据 。 

如 果 我 们 只 在 构建 文件 里 指定 这 些 功能 ,让 构建 过 程 自 己 搞 明 白 我 们 要 什么 东西 ， 岂 不 是 更 
简单 ? 这 正 是 Spring Boot 起 步 依 赖 的 功能 。 


2.2.1 指定 基于 功能 的 依赖 


Spring Boot 通 过 提供 众多 起 步 依赖 降低 项 目 依赖 的 复杂 度 。 起 步 依赖 本 质 上 是 一 个 Maven 项 
目 对 象 模型 ( Project Object Model, POM )， 定 义 了 对 其 他 库 的 传递 依赖 ， 这 些 东 西 加 在 一 起 即 
支持 某 项 功能 。 很 多 起 步 依赖 的 命名 都 暗示 了 它们 提供 的 某 种 或 某 类 功能 。 
举例 来 说 ， 你 打算 把 这 个 阅读 列表 应 用 程序 做 成 一 个 Web 应 用 程序 。 与 其 向 项 目的 构建 文件 
里 添加 一 堆 单 独 的 库 依赖 ， 还 不 如 声明 这 是 一 个 Web 应 用 程序 来 得 简单 。 你 只 要 添加 Spring Boot 
的 Web 起 步 依赖 就 好 了 。 
我 们 还 想 以 Thymeleaf 为 Web 视 图 ， 用 JPA 来 实现 数据 持久 化 ， 因 此 在 构建 文件 里 还 需要 
Thymeleaf 和 Spring Data JPA 的 起 步 依 赖 。 
为 了 能 进行 测试 ,我 们 还 需要 能 在 Spring Boot 上 下 文 里 运行 集成 测试 的 库 , 因此 要 添加 Spring 
Boot 的 test 起 步 依赖 ， 这 是 一 个 测试 时 依赖 。 
统统 放 在 一 起 ， 就 有 了 这 五 个 依赖 ， 也 就 是 Initializr 在 Gradle 的 构建 文件 里 提供 的 : 
dependencies { 
compile "org.springframework.boot:spring-boot-starter-web" 
compile "org.springframework.boot:spring-boot-starter-thymeleaf" 
compile "org.springframework.boot:spring-boot-starter-data-jpa" 
compile "com.h2database:h2" 


testCompile("org.springframework.boot:spring-boot-starter-test") 


} 


正如 先前 所 见 , 添加 这 些 依赖 的 最 简单 方法 就 是 在 Initializr 里 选中 Web 、Thymeleaf 和 JPA 复 选 
框 。 但 如 果 在 初始 化 项 目 时 没有 这 人 么 做 ， 当 然 也 可 以 稍 后 再 编辑 生成 的 build.gradle 或 pom.xml。 

通过 传递 依赖 ， 添 加 这 四 个 依赖 就 等 价 于 加 了 一 大 把 独立 的 库 。 这 些 传递 依赖 涵盖 了 Spring 
MVC, Spring Data JPA 、Thymeleaf 等 内 容 ， 它 们 声明 的 依赖 也 会 被 传递 依赖 进来 。 

最 值得 注意 的 是 ， 这 四 个 起 步 依赖 的 具体 程度 恰到好处 。 我 们 并 没有 说 想 要 Spring MVC, 
只 是 说 想 要 构建 一 个 Web 应 用 程序 。 我 们 并 没有 指定 JUnit 或 其 他 测试 工具 ,只 是 说 我 们 想 要 测试 
自己 的 代码 。Thymeleaf 和 Spring Data JPA 的 起 步 依 赖 稍微 具体 一 点 , 但 这 也 只 是 由 于 没有 更 模糊 
的 方法 声明 这 种 需要 。 







































































































































































2.2 ”使 用 起 步 依赖 29 








这 四 个 起 步 依赖 只 是 Spring Boot 众 多 起 步 依 赖 中 的 沧海 一 栗 。 附录 B 罗 列 出 了 全 部 起 步 依赖 ， 
并 简要 描述 了 一 下 它们 向 项 目 构建 引入 了 什么 。 

我 们 并 不 需要 指定 版 本 号 ， 起 步 依 赖 本 身 的 版 本 是 由 正在 使 用 的 Spring Boot 的 版 本 来 决定 
的 ， 而 起 步 依 赖 则 会 决定 它们 引入 的 传递 依赖 的 版 本 。 

不 知道 自己 所 用 依赖 的 版 本 ， 你 多 少 会 有 些 不 安 。 你 要 有 信心 ， 相 信 Spring Boot 经 过 了 足够 
的 测试 ， 确 保 引 入 的 全 部 依赖 都 能 相互 兼容 。 这 是 一 种 解脱 ， 只 需 指 定 起 步 依赖 ， 不 用 担心 自己 
需要 维护 哪些 库 ， 也 不 必 担 心 它们 的 版 本 。 

但 如 果 你 真 想 知 道 自己 在 用 什么 ， 在 构建 工具 里 总 能 找到 你 要 的 答案 。 在 Gradle 里 ， 
dependencies 任 务 会 显示 一 个 依赖 树 ， 其 中 包含 了 项 目 所 用 的 每 一 个 库 以 及 它们 的 版 本 : 

$ gradle dependencies 

在 Maven 里 使 用 dependency 持 件 的 tree 目 标 也 能 获得 相似 的 依赖 树 。 

$ mvn dependency:tree 

大 部 分 情况 下 ， 你 都 无 需 关心 每 个 Spring Boot 起 步 依赖 分 别 声 明了 些 什么 东西 。Web 起 步 依 
赖 能 让 你 构建 Web 应 用 程序 , Thymeleaf 起 步 依赖 能 让 你 用 Thymeleaf 模 板 ，Spring Data JPA 起 步 依 
赖 能 让 你 用 Spring Data JPA 将 数据 持久 化 到 数据 库 里 ， 通 常 只 要 知道 这 些 就 足够 了 。 

但 是 ， 即 使 经 过 了 Spring Boot 团 队 的 测试 ,起 步 依赖 里 所 选 的 库 仍 有 问题 该 怎么 办 ? m fe 
盖 起 步 依赖 呢 ? 


2.2.2 ”覆盖 起 步 依 赖 引 入 的 传递 依赖 


说 到 底 , 起 步 依赖 和 你 项 目 里 的 其 他 依赖 没什么 区 别 。 也 就 是 说 ,你 可 以 通过 构建 工具 中 的 
功能 , 选择 性 地 覆盖 它们 引入 的 传递 依赖 的 版 本 号 ,排除 传递 依赖 ,当然 还 可 以 为 那些 Spring Boot 
起 步 依赖 没有 涵盖 的 库 指定 依赖 。 

以 Spring Boot 的 Web 起 步 依赖 为 例 ， 它 传递 依赖 了 Jackson JSON 库 。 如 果 你 正在 构建 一 个 生 
产 或 消费 JSON 资 源 表 述 的 REST 服 务 ， 那 它 会 很 有 用 。 但 是 ， 要 构建 传统 的 面向 人 类 用 户 的 Web 
应 用 程序 ， 你 可 能 用 不 上 Jackson。 虽 然 把 它 加 进来 也 不 会 有 什么 坏处 ， 但 排除 掉 它 的 传递 依赖 ， 
可 以 为 你 的 项 目 瘦身 。 

如 果 在 用 Gradle， 你 可 以 这 样 排除 传递 依赖 : 

compile("org.springframework.boot:spring-boot-starter-web") ( 


exclude group: 'com.fasterxml.jackson.core' 


} 


在 Maven 里 ， 可 以 用 <exclusions> 元 素来 排除 传递 依赖 。 下 面 这 个 引入 Spring Boot 的 
build.gradle 的 <dependency> 增 加 了 <exclusions > 元 素 去 除 Jackson: 



































































































































<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-web«/artifactId» 
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«exclusions» 
«exclusion» 
«groupId»com.fasterxml.jackson.core«/groupId» 
«/exclusion» 
«/exclusions» 
</dependency> 


另 一 方面 , 也 许 项 目 需要 Jackson, 但 你 需要 用 另 一 个 版 本 的 Jackson 来 进行 构建 ， 而 不 是 Web 
起 步 依赖 里 的 那个 。 假 设 Web 起 步 依赖 引用 了 Jackson 2.3.4， 但 你 需要 使 用 2.4.32。 在 Maven 里 ， 
你 可 以 直接 在 pom.xml 中 表达 诉求 ， 就 像 这 样 : 

<dependency> 

«groupId»com.fasterxml.jackson.core«/groupId» 
«artifactId»jackson-databind«/artifactId» 


«version»2.4.3«/version» 
</dependency> 


Maven 总 是 会 用 最 近 的 依赖 ， 也 就 是 说 ， 你 在 项 目的 构建 说 明文 件 里 增加 的 这 个 依赖 ， 会 覆 
盖 传 递 依赖 引入 的 另 一 个 依赖 。 
与 之 类 似 ， 如 果 你 用 的 是 Gradle， 可 以 在 build.gradle 文 件 里 指明 你 要 的 Jackson 的 版 本 : 


compile("com.fasterxml.jackson.core:jackson-databind:2.4.3") 


因为 这 个 依赖 的 版 本 比 Spring Boot 的 Web 起 步 依赖 引入 的 要 新 ， 所 以 在 Gradle 里 是 生效 的 。 
但 假如 你 要 的 不 是 新 版 本 的 Jackson， 而 是 一 个 较 早 的 版 本 呢 ? Gradle 和 Maven 不 太一 样 ，Gradle 
倾向 于 使 用 库 的 最 新 版 本 。 因 此 ， 如 果 你 要 使 用 老 版 本 的 Jackon， 则 不 得 不 把 老 版 本 的 依赖 加 入 
构建 ， 并 把 Web 起 步 依 赖 传递 依赖 的 那个 版 本 排除 掉 : 


compile("org.springframework.boot:spring-boot-starter-web") { 
exclude group: 'com.fasterxml.jackson.core' 
j 


compile("com.fasterxml.jackson.core:jackson-databind:2.3.1") 

不 管 什么 情况 ,在 覆盖 Spring Boot 起 步 依 赖 引 入 的 传递 依赖 时 都 要 多 加 小 心 。 虽 然 不 同 的 版 
本 放 在 一 起 也 许 没什么 问题 , 但 你 要 知道 , 起 步 依赖 中 各 个 依赖 版 本 之 间 的 兼容 性 都 经 过 了 精心 
的 测试 。 应 该 只 在 特殊 的 情况 下 覆盖 这 些 传递 依赖 〈 比如 新 版 本 修复 了 一 个 bug )。 

现在 我 们 有 了 一 个 空 的 项 目 结构 , 构建 说 明文 件 也 准备 好 了 , 是 时 候 开 发 应 用 程序 了 。 我 们 
会 让 Spring Boot 来 处 理 配 置 细节 ， 而 我 们 自己 则 专注 于 编写 阅读 列表 功能 相关 的 代码 。 


2.3 ”使 用 自动 配置 


简 而 言 之 , Spring Boot 的 自动 配置 是 一 个 运行 时 (更 准确 地 说 , 是 应 用 程序 启动 时 ) 的 过 程 ， 
考虑 了 众多 因素 ， 才 决定 Spring 配 置 应 该 用 哪个 ， 不 该 用 哪个 。 举 几 个 例子 ， 下 面 这 些 情况 都 是 














































































































































































































CD 此 处 提 到 的 版 本 仅 作 演示 之 用 ，Spring Boot 的 Web 起 步 依 赖 所 引用 的 实际 Jackson 版 本 由 你 使 用 的 Spring Boot 版 本 
决定 。 
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Spring Boot 的 自动 配置 要 考虑 的 。 
O Spring 的 JabcTemplate 是 不 是 在 Classpath 里 ?” 如 果 是 ， 并 且 有 Datasource 的 Bean， 则 
自动 配置 一 个 JdbcTemplate 的 Bean。 
口 Thymeleaf 是 不 是 在 Classpath 里 ?如果 是 ， 则 配置 Thymeleaf 的 模板 解析 器 、 视 图 解析 器 以 
及 模板 引擎 。 
口 Spring Security 是 不 是 在 Classpath 里 ? 如 果 是 ， 则 进行 一 个 非常 基本 的 Web 安 全 设置 。 
每 当 应 用 程序 启动 的 时 候 ，Spring Boot 的 自动 配置 都 要 做 将 近 200 个 这 样 的 决定 ， 涵 盖 安 全 、 
集成 、 持 久 化 、Web 开 发 等 诸多 方面 。 所 有 这 些 自 动 配置 就 是 为 了 尽量 不 让 你 自己 写 配 置 。 
有 意思 的 是 ,自动 配置 的 东西 很 难 写 在 书本 里 。 如 果 不 能 写 出 配置 , 那 又 该 怎么 描述 并 讨论 
它们 呢 ? 


2.3.1 专注 于 应 用 程序 功能 


要 为 Spring Boot 的 自动 配置 博得 好 感 ， 我 可 以 在 接 下 来 的 几 页 里 向 你 演示 没有 Spring Boot 的 
情况 下 需要 写 哪些 配置 。 但 眼下 已 经 有 不 少 好 书写 过 这 些 内 容 了 , 再 写 一 次 并 不 能 让 我 们 更 快 地 
写 好 阅读 列表 应 用 程序 。 

既然 知道 Spring Boot 会 蔡 我 们 料理 这 些 事 情 ， 那 么 与 其 浪费 时 间 讨 论 这 些 Spring 配置 ， 还 
如 看 看 如 何 利 用 Spring Boot 的 自动 配置 ， 让 我 们 专注 于 应 用 程序 代码 。 除 了 开始 写 代码 ， 我 想 
到 更 好 的 办 法 了 。 

1. 定义 领域 模型 

我 们 应 用 程序 里 的 核心 领域 概念 是 读者 阅读 列表 上 的 书 。 因此 我 们 需要 定义 一 个 实体 类 来 表 
示 这 个 概念 。 代 码 清单 2-5 演 示 了 如 何 定义 一 本 书 。 


代码 清单 2-5 ”表示 列表 里 的 书 的 Book 类 


package readinglist; 



































































































































2i 5 

















import javax.persistence.Entity; 

import javax.persistence.GeneratedValue; 
import javax.persistence.GenerationType; 
import javax.persistence.Id; 


GEntity 
public class Book ( 


@Id 

@GeneratedValue (strategy=GenerationType.AUTO) 
private Long id; 

private String reader; 

private String isbn; 

private String title; 

private String author; 

private String description; 
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public Long getId() ( 
return id; 


public void setId(Long id) ( 
this.id - id; 


public String getReader() ( 
return reader; 


public void setReader(String reader) ( 
this.reader - reader; 


public String getIsbn() ( 
return isbn; 


public void setIsbn(String isbn) ( 
this.isbn = isbn; 


public String getTitle() ( 
return title; 


public void setTitle(String title) ( 
this.title - title; 


public String getAuthor() ( 
return author; 


public void setAuthor(String author) ( 
this.author - author; 


public String getDescription() ( 
return description; 


public void setDescription(String description) ( 
this.description - description; 


j 

如 你 所 见 ，Book 类 就 是 简单 的 Java 对 象 ， 其 中 有 些 描述 书 的 属性 ， 还 有 必要 的 访问 方法 。 
Entity 注 解 表 明 它 是 一 个 JPA 实 体 ，id 属 性 加 了 @Id 和 @Generatedvalue 注 解 , 说明 这 个 字段 
是 实体 的 唯一 标识 ， 并 且 这 个 字段 的 值 是 自动 生成 的 。 








(人 
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2. 定义 仓库 接口 
接 下 来 , 我 们 就 要 定义 用 于 把 Book 对 象 持久 化 到 数据 库 的 仓库 了 。" 因 为 用 了 Spring Data JPA, 
所 以 我 们 要 做 的 就 是 简单 地 定义 一 个 接口 ， 扩 展 一 下 Spring Data JPA 的 JpaRepository 接 口 : 


package readinglist; 


import java.util.List; 
import org.springframework.data.jpa.repository.JpaRepository; 


public interface ReadingListRepository extends JpaRepository«Book, Long» ( 









































List«Book» findByReader(String reader); 


j 
通过 扩展 JpaRepository， ReadingListRepository 直 接 继承 了 18 个 执行 常用 持久 化 操作 
的 方法 。JpaRepository 是 个 泛 型 接口 ， 有 两 个 参数 : 仓库 操作 的 领域 对 象 类 型 ， 及 其 ID 属性 的 
类 型 。 此 外 ， 我 还 增加 了 一 个 fingdByReader () 方 法 ， 可 以 根据 读者 的 用 户 名 来 查找 阅读 列表 。 

如 果 你 好 奇 谁 来 实现 这 个 ReaaingListRepository 及 其 继承 的 18 个 方法 ， 请 不 用 担心 ， 
Spring Data 提 供 了 很 神奇 的 魔法 ， 只 需 定 义 仓库 接口 ， 在 应 用 程序 启动 后 ， 该 接口 在 运行 时 会 自 
动 实现 。 

3. 88 Web7 E 

现在 ， 我 们 定义 好 了 应 用 程序 的 领域 模型 ， 还 有 把 领域 对 象 持久 化 到 数据 库 里 的 仓库 接口 ， 
剩 下 的 就 是 创建 Web 前 端 了 。 代 码 清单 2-6 的 Spring MVC 控 制 器 就 能 为 应 用 程序 处 理 HTTP 请 求 。 


代码 清单 2-6 ”作为 阅读 列表 应 用 程序 前 端的 Spring MVC 控 制 带 


package readinglist; 






























































import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.stereotype.Controller; 

import org.springframework.ui.Model; 

import org.springframework.web.bind.annotation.PathVariable; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 
import java.util.List; 








GController 
GRequestMapping("/") 
public class ReadingListController ( 


private ReadingListRepository readingListRepository; 


GAutowired 
public ReadingListController( 
ReadingListRepository readingListRepository) ( 
this.readingListRepository - readingListRepository; 




















(D 原文 这 里 写 的 是 ReadingList 对 象 ， 但 文中 并 没有 定义 这 个 对 象 ， 看 代码 应 该 是 Book 对 象 。 一 一 译 者 注 
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GRequestMapping(value-"/(reader)", method-RequestMethod.GET) 
public String readersBooks( 

GPathVariable("reader") String reader, 

Model model) { 


List«Book» readingList - 
readingListRepository.findByReader (reader); 
if (readingList !- null) ( 
model.addAttribute("books", readingList); 
j 
return "readingList"; 


} 


@RequestMapping (value="/{reader}", method-RequestMethod.POST) 
public String addToReadingList( 
GPathVariable("reader") String reader, Book book) ( 
book.setReader(reader); 
readingListRepository.save (book); 
return "redirect:/íreader)]"; 


j 


} 

ReadingListController 使 用 了 @controller 注 解 ， 这 样 组件 扫 描 会 自动 将 其 注册 为 
Spring 应 用 程序 上 下 文 里 的 一 个 Bean。 它 还 用 了 eRequestMapping 注 解 ， 将 其 中 所 有 的 处 理 器 
方法 都 映射 到 了 “/” 这 个 URL 路 径 上 。 

该 控制 器 有 两 个 方法 。 

O readersBooks () : 处 理 /{reader} 上 的 HTTP GET 请 求 ， 根 据 路 径 里 指定 的 读者 ， 从 GB 

过 控制 器 的 构造 器 注入 的 ) 仓库 获取 Book 列 表 。 随 后 将 这 个 列表 塞 人 模型 ， 用 的 键 是 
booker PUE esha eel PEETA EE CUM. 

O addToReadingList(): 处 理 /{reader} 上 的 HTTP PosT 请 求 ， 将 请 求 正 文 里 的 数据 绑 定 

到 一 个 Book 对 象 上 。 该 方法 把 Book 对 象 的 reader 属 性 设置 为 读者 的 姓名 ， 随 后 通过 仓 
库 的 save () 方 法 保存 修改 后 的 Book 对 象 ， 最 后 重 定向 到 /freader} ( 控制 器 中 的 另 一 个 方 
法 会 处 理 该 请 求 )。 

a EEren el li R NE A E 
在 项 目 开 始 之 初 我 就 决定 要 用 Thymeleaf 来 定义 应 用 程序 的 视图 ， 所 以 接 下 来 就 在 src/main/ 
resources/templates 里 创建 一 个 名 为 readingList.html 的 文件 ， 内 容 如 代码 清单 2-7 所 示 。 


代码 清单 2-7 呈现 阅读 列表 的 Thymeleaf 异 板 
«html» 
<head> 
<title>Reading List</title> 
«link rel="stylesheet" th:href-"G(/style.css)"»«/link» 
</head> 


























<body> 
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<h2>Your Reading List«/h2» 
«div th:unless-"$(dlists.isEmpty (books))"» 
«dl th:each-"book : $(books)"» 
«dt class-"bookHeadline"'-» 
«span th:text-"$(book.title)"»Title«/span» by 
<span th:text-"$(book.author)"»Author«/span» 
(ISBN: «span th:text-"$(book.isbn)"»ISBN«/span») 
«/dt» 
«dd class-"bookDescription"-» 
«span th:if-"$(book.description)" 
th:text-"$(book.description)"»Description«c/span» 
«span th:if-"$(book.description eq null}"> 
No description available«c/span» 








«/dd» 
«/dl» 
«/div» 
«div th:if-"$(s4lists.isEmpty (books))"» 
«p»You have no books in your book list«/p» 
</div> 


<hr/> 


<h3>Add a book</h3> 
<form method="POST" > 
<label for="title">Title:</label> 
<input type="text" name="title" size="50"></input><br/> 
<label for="author">Author:</label> 
<input type="text" name="author" size="50"></input><br/> 
<label for="isbn">ISBN:</label> 
<input type="text" name="isbn" size="15"></input><br/> 
«label for="description">Description:</label><br/> 
«textarea name-"description" cols-"80" rows="5"> 
«/textarea»«br/» 
«input type-"submit"»«/input» 
</form> 





</body> 
</html> 


这 个 模板 定义 了 一 个 HTML 页 面 ,该 页 面 概念 上 分 为 两 个 部 分 : 页 面 上 方 是 读者 的 阅读 列表 
中 的 图 书 清单 ; 下 方 是 是 一 个 表单 ， 读 者 可 以 从 这 里 添加 新 书 。 

为 了 美观 ,Thymeleaf 异 板 引 用 了 一 个 名 为 style.css 的 样式 文件 , 该 文件 位 于 src/main/resources/ 
static 目 录 中 ， 看 起 来 是 这 样 的 : 


body { 
background-color: f$cccccoc; 
font-family: arial,helvetica,sans-serif; 


























.bookHeadline ( 
font-size: 12pt; 
font-weight: bold; 
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.bookDescription ( 
font-size: 10pt; 
} 


label { 
font-weight: bold; 
} 


这 个 样式 表 并 不 复杂 ,也 没有 过 分 追求 让 应 用 程序 变 漂亮 , 但 已 经 能 满足 我 们 的 需求 了 。 很 
快 你 就 会 看 到 ， 它 能 用 来 演示 Spring Boot 的 自动 配置 功能 。 

不 管 你 相 不 相信 ，, 以 上 就 是 一 个 完整 的 应 用 程序 了 一 一 本 章 已 经 向 你 呈现 了 所 有 的 代码 。 等 
一 下 ， 回 顾 一 下 前 几 页 的 内 容 ， 你 看 到 什么 配置 了 吗 ? 实际 上 ， 除 了 代码 清单 2-1 里 的 三 行 配置 
( 这 是 开启 自动 配置 所 必需 的 )， 你 不 用 再 写 任何 Spring 配置 了 。 

虽然 没什么 Spring 配置 ， 但 这 已 经 是 一 个 可 以 运行 的 完整 Spring 应 用 程序 了 。 让 我 们 把 它 运 
行 起 来 ， 看 看 会 怎样 。 


2.3.2 ”运行 应 用 程序 


运行 Spring Boot 应 用 程序 有 几 种 方法 。 先 前 在 2.5 节 里 ， 我 们 讨论 了 如 何 通过 Maven 和 Gradle 
来 运行 应 用 程序 ， 以 及 如 何 构 建 并 运行 可 执行 JAR。 稍 后 ， 在 第 8 章 里 你 将 看 到 如 何 构建 WAR 文 
件 ， 并 用 传统 的 方式 部 署 到 Java Web 应 用 服务 器 里 ， 比 如 Tomcat。 

假设 你 正 使 用 Spring Tool Suite 开 发 应 用 程序 , 可 以 在 IDE 里 选中 项 目 , 在 Run 菜 单 里 选择 Run 
As > Spring Boot App， 通 过 这 种 方式 来 运行 应 用 程序 ， 如 图 2-3 所 示 。 
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图 2-3 ”在 Spring Tool Suite 里 运行 Spring Boot 应 用 程序 
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如 果 一 切 正常 , 你 的 浏览 器 应 该 会 展现 一 个 空白 的 阅读 列表 , 下 方 有 一 个 用 于 向 列表 添加 新 
书 的 表单 ， 如 图 2-4 所 示 。 





eoc Reading x 
(E| ( + | localhost:8080/readingList/craig € |; Reader: If .ama 





图 2-4 ”初始 状态 下 的 空 阅读 列表 
接 下 来 ,通过 表单 添加 一 些 图 书 吧 。 随 后 你 的 阅读 列表 看 起 来 就 会 像 图 2-5 这 样 。 





图 2-5 添加 了 一 些 图 书后 的 阅读 列表 
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再 多 用 用 这 个 应 用 程序 吧 。 你 准备 好 之 后 ,我 们 就 来 看 一 下 Spring Boot 是 如 何 做 到 不 写 Spring 




















配置 代码 就 能 开发 整个 Spring 应 用 程序 的 。 
2.3.3 刚刚 发 生 了 什么 


iini 





如 我 所 说 ,在 没有 配置 代码 的 情况 下 ,很 难 描述 自动 配置 。 与 其 花 时 间 讨 论 那些 你 不 用 做 的 





丰 情 ， 不 如 在 这 一 节 里 关注 一 下 你 要 做 的 事 一 一 写 代码 。 








当然 , 某 处 肯定 是 有 些 配置 的 .配置 是 Spring Framework 的 核心 元 素 ,必须 要 有 东西 告诉 Spring 





如 何 运行 应 用 程序 。 





在 向 应 用 程序 加 入 Spring Boot 时 , 有 个 名 为 spring-boot-autoconfigure 的 JAR 文 件 , 其 中 包含 了 








很 多 配置 类 。 每 个 配置 类 都 在 应 用 程序 的 Classpath 里 ,都 有 机 会 为 应 用 程序 的 配置 添砖加瓦 。 这 


些 配 置 类 里 有 用 于 Thymeleaf 的 配置 ， 有 用 于 Spring Data JPA 的 配置 ， 有 用 于 Spiring MVC 的 配置 ， 




















还 有 很 多 其 他 东西 的 配置 ， 你 可 以 自己 选择 是 否 在 Spring 应 用 程序 里 使 用 它们 。 














所 有 这 些 配 置 如 此 与 众 不 同 ， 原 因 在 于 它们 利用 了 Spring 的 条 件 化 配置 ， 这 是 Spring 4.0 引 入 





的 新 特性 。 条 件 化 配置 允许 配置 存在 于 应 用 程序 中 ,但 在 满足 某 些 特定 条 件 之 前 都 忽略 这 个 配置 。 














在 Spring 里 可 以 很 方便 地 编写 你 自己 的 条 件 , 你 所 要 做 的 就 是 实现 conaition 接 口 ， 覆盖 它 


的 matches () 方 法 。 举 例 来 说 ,下 面 这 个 简单 的 条 件 类 只 有 在 Classpath 里 存在 JdbcTemplate 时 
才 会 生效 : 


package readinglist; 

import org.springframework.context.annotation.Condition; 

import org.springframework.context.annotation.ConditionContext; 
import org.springframework.core.type.AnnotatedTypeMetadata; 


public class JdbcTemplateCondition implements Condition ( 
GOverride 
public boolean matches (ConditionContext context, 
AnnotatedTypeMetadata metadata) ( 
try ( 
context.getClassLoader().loadClass( 
"org.springframework.jdbc.core.JdbcTemplate"); 
return true; 
) catch (Exception e) ( 
return false; 
j 
j 
} 


当 你 用 Java 来 声明 Bean 的 时 候 ， 可 以 使 用 这 个 自 定义 条 件 类 : 


@Conditional (JdbcTemplateCondition.class) 
public MyService myService() ( 


} 
在 这 个 例子 里 ,只 有 当 JqbcTemplatecondqition 类 的 条 件 成 立时 才 会 创建 Mvservice 这 个 


























Bean。 也 就 是 说 MyService Bean 创 建 的 条 件 是 Classpath 里 有 JabcTemplate。 否 则 ， 这 个 Bean 
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的 声明 就 会 被 忽略 掉 。 

虽然 本 例 中 的 条 件 相 当 简 单 , 但 Spring Boot 定 义 了 很 多 更 有 趣 的 条 件 ， 并 把 它们 运用 到 了 配 
置 类 上 ， 这 些 配置 类 构成 了 Spring Boot 的 自动 配置 。Spring Boot 运 用 条 件 化 配置 的 方法 是 ， 定 义 
多 个 特殊 的 条 件 化 注解 ， 并 将 它们 用 到 配置 类 上 。 表 2-1 列 出 了 Spring Boot 提 供 的 条 件 化 注解 。 


表 2-1 自动 配置 中 使 用 的 条 件 化 注解 





















































条 件 化 注解 配置 生效 条 件 
GConditionalOnBean 配置 了 某 个 特定 Bean 
@ConditionalOnMissingBean 没有 配置 特定 的 Bean 
econditionalonCclass Classpath 里 有 指定 的 类 
GConditionalOnMissingClass Classpath 里 缺少 指定 的 类 
@ConditionalOnExpression 给 定 的 Spring Expression Language (SpEL) 表达 式 计算 结果 为 true 
Send pionalOnTava Java 的 版 本 匹配 特定 值 或 者 一 个 范围 值 
&ConditionalOnJndi 参数 中 给 定 的 JNDI 位 置 必须 存在 一 个 ， 如 果 没 有 给 参数 ， 则 要 有 JNDI 
InitialContext 
GConditionalOnProperty 指定 的 配置 属性 要 有 一 个 明确 的 值 
GConditionalOnResource Classpath 里 有 指定 的 资源 
GConditionalOnWebApplication 这 是 一 个 Web 应 用 程序 
GConditionalOnNotWebApplication 这 不 是 一 个 Web 应 用 程序 











一 般 来 说 ， 无 需 查看 Spring Boot 自 动 配置 类 的 源 代码 ， 但 为 了 演示 如 何 使 用 表 2-1 里 的 注解 ， 
我 们 可 以 看 一 下 DataSourceAutoConfiguration 里 的 这 个 片段 (这 是 Spring Boot 自 动 配置 库 
的 一 部 分 ): 


@Configuration 

@ConditionalOnClass({ DataSource.class, EmbeddedDatabaseType.class }) 
@EnableConfigurationProperties (DataSourceProperties.class) 

@Import ({ Registrar.class, DataSourcePoolMetadataProvidersConfiguration.class }) 
public class DataSourceAutoConfiguration { 








} 


如 你 所 见 ，DataSourceAutoConfiguration 添 加 了 @Configuration 注 解 ， 它 从 其 他 配 
置 类 里 导入 了 一 些 额 外 配置 ， 还 自己 定义 了 一 些 Bean。 最 重要 的 是 ，DataSourceAutoCon- 
figuration 上 添加 了 econdaitionalonclass 注 解 ， 要 求 Classpath 里 必须 要 有 Datasource 和 
beddedDatabaseTypes 如 果 它 们 不 存在 ， 条 件 就 不 成 立 ， DataSourceAutoConfiguration 
提供 的 配置 都 会 被 忽略 掉 。 

DataSourceAutoConfigurationl HE A f —/JdbcTemplateConfiguration2S$, [3j 
配置 了 一 个 JdbcTemplate Bean: 























E 








GConfiguration 
QGConditional(DataSourceAutoConfiguration.DataSourceAvailableCondition.class) 
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protected static class JdbcTemplateConfiguration { 


GAutowired(required - false) 
private DataSource dataSource; 


GBean 
GConditionalOnMissingBean(JdbcOperations.class) 
public JdbcTemplate jdbcTemplate() ( 

return new JdbcTemplate(this.dataSource); 


} 


} 


JdbcTemplateConfiguration 使 用 了 @congditional 注 解 ， 判 断 DatasSourceAvailable- 
congdition 条 件 是 否 成 立 一 一 基本 上 就 是 要 有 一 个 Datasource Bean 或 者 要 自动 配置 创建 一 个 。 
假设 有 Datasource Bean, 使 用 了 @Bean 注 解 的 jdbcTemplate() 方 法 会 配置 一 个 
JdbcTemplate Bean。 这 个 方法 上 还 加 了 econaitionalonMissingBean 注 解 ， 因 此 只 有 在 不 
存在 J dbcOperat ions( 即 JabcTemplate 实 现 的 接口 ) 类 型 的 Bean 时 ， 才 会 创建 JdbcTemplate 
Beans 
此 处 看 到 的 只 是 patasourceaAutoconfiguration 的 冰山 一 角 ，Spring Boot 提 供 的 其 他 自 
动 配置 类 也 有 很 多 知识 没有 提 到 。 但 这 已 经 足以 说 明 Spring Boot 如 何 利 用 条 件 化 配置 实现 自动 
配置 。 

自动 配置 会 做 出 以 下 配置 决策 ， 它 们 和 之 前 的 例子 息息相关 。 

O 因为 Classpath 里 有 H2， 所 以 会 创建 一 个 租 入 式 的 H2 数 据 库 Bean ， 它 的 类 型 是 

javax.sql.DataSource，JPA 实 现 ( Hibernate ) 需要 它 来 访问 数据 库 。 

口 因为 Classpath 里 有 Hibernate ( Spring Data JPA 传 递 引入 的 ) 的 实体 管理 器 ， 所 以 自动 配置 
会 配置 与 Hiberate 相 关 的 Bean ， 包 括 Spring 的 LocalcontainerEntityManager- 
FactoryBean 和 JpaVendorAdapter。 

口 因为 Classpath 里 有 Spring Data JPA， 所 以 它 会 自动 配置 为 根据 仓库 的 接口 创建 仓库 实现 。 

口 因为 Classpath 里 有 Thymeleaf， 所 以 Thymeleaf 会 配置 为 Spring MVC 的 视图 ， 包 括 一 个 
Thymeleaf 的 模板 解析 器 、 模 板 引 擎 及 视图 解析 器 。 视 图 解析 器 会 解析 相对 于 Classpath 根 
目录 的 /templates 目 录 里 的 模板 。 

口 因 为 Classpath 里 有 Spring MVC ( 归功 于 Web 起 步 依 赖 )， 所 以 会 配置 Spring 的 

DispatcherServlet 并 启用 Spring MVC, 

口 因为 这 是 一 个 Spring MVC Web 应 用 程序 , 所 以 会 注册 一 个 资源 处 理 器 , 把 相对 于 Classpath 
根 目录 的 /static 目 录 里 的 静态 内 容 提供 出 来 。( 这 个 资源 处 理 器 还 能 处 理 /public 、/resources 
和 /META-INF/resources 的 静态 内 容 。 ) 

口 因为 Classpath 里 有 Tomcat( 通过 Web 起 步 依赖 传递 引用 ), 所 以 会 启动 一 个 能 入 式 的 Tomcat 
容器 ， 监 听 8080 端 口 。 
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由 此 可 见 ，Spring Boot 自 动 配置 承担 起 了 配置 Spring 的 重任 ， 因 此 你 能 专注 于 编写 自己 的 应 
用 程序 。 














2.4 小 结 


通过 Spring Boot 的 起 步 依赖 和 自动 配置 ， 你 可 以 更 加 快速 、 便 捷 地 开发 Spring 应 用 程序 。 起 
步 依赖 帮助 你 专注 于 应 用 程序 需要 的 功能 类 型 ， 而 非 提供 该 功能 的 具体 库 和 版 本 。 与 此 同时 ， A 
动 配置 把 你 从 样板 式 的 配置 中 解放 了 出 来 。 这 些 配置 在 没有 Spring Boot 的 Spring 应 用 程序 里 非常 
JLo 

虽然 自动 配置 很 方便 ， 但 在 开发 Spring 应 用 程序 时 其 中 的 一 些 用 法 也 有 点 武断 。 要 是 你 在 配 
置 Spring 时 希望 或 者 需要 有 所 不 同 , 该 怎么 办 ”在 第 3 章 , 我 们 将 会 看 到 如 何 履 盖 Spring Boot 自 动 
配置 ， 借 此 达成 应 用 程序 的 一 些 目标 ， 还 有 如 何 运 用 类 似 的 技术 来 配置 自己 的 应 用 程序 组 件 。 




































































本 章 内 容 

a 覆盖 自动 配置 的 Bean 
口 用 外 置 属性 进行 配置 
口 自 定 义 错 误 页 

















能 自由 选择 真是 大 棒 了 。 如 果 你 订 过 比萨 《有 没 订 过 的 吗 ? ) 就 会 知道 ， 








尔 完全 可 以 掌控 注 

















饼 上 放 哪 些 辅料 。 选 定 腊肠 、 意 大 利 辣 香 肠 、 青 羔 椒 和 额外 芝士 的 时 候 , 你 就 是 在 按照 自己 的 要 





求 配置 比萨 。 











另 一 方面 , 大 部 分 比萨 店 也 提供 菜 种 形式 的 自动 配置 。 你 可 以 点 莹 比萨 、 素 比萨 、 香 阁 意 大 








利 比 萨 , 或 者 是 自动 配置 比萨 中 的 极品 
所 点 的 比萨 种 类 决定 了 所 用 的 辅料 。 








至 尊 比 萨 。 在 下 单 时 ， 你 并 没有 指定 具体 的 辅料 ， 你 





但 如 果 你 想 要 至 尊 比 萨 上 的 全 部 辅料 , 还 想 要 加 墨西哥 胡椒 ， 又 不 想 放 蘑菇 该 怎么 办 ? 你 偏 
爱 羔 食 又 不 喜欢 吃 菌 类 ， 自 动 配置 不 适合 你 的 口味 , 你 就 只 能 自己 配置 比 艾 了 吗 ? 当 然 不 是 , 大 














部 分 比萨 店 会 让 你 以 菜单 上 已 有 的 选项 为 基础 进行 定制 。 























使 用 传统 Spring 配置 的 过 程 ， 就 如 同 订 比 萨 的 时 候 自己 指定 全 部 的 辅料 。 你 可 以 完全 掌控 
































Spring 配置 的 内 容 ， 可 是 显 式 声明 应 用 程序 里 全 部 的 Bean 并 不 是 明智 之 举 。 而 Spring Boot 自 动 配 





置 就 像 是 从 菜单 上 选 一 份 特色 比萨 , 让 Spring Boot 处 理 各 种 细节 比 自己 声明 上 下 文 里 全 部 的 Bean 








要 容易 很 多 。 








AAWE, Spring Boot 自 动 配置 非常 灵活 。 就 像 比萨 厨师 可 以 不 在 你 的 比萨 里 放 蘑 菇 ， 而 是 








加 墨西哥 胡椒 一 样 ，Spring Boot 能 让 你 参与 进来 ， 影 响 自动 配置 的 实施 。 











本 章 我 们 将 看 到 两 种 影响 自动 配置 的 方式 一 一 使 用 显 式 配置 进行 覆盖 和 使 用 属性 进行 精细 








化 配置 。 我 们 还 会 看 到 如 何 使 用 Spring Boot 提 供 的 钓 子 引入 自 定义 的 错误 页 。 
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一 般 来 说 ， 如 果 不 用 配置 就 能 得 到 和 显 式 配 置 一 样 的 结果 ， 那 么 不 写 配置 是 最 直接 的 选择 。 

















既然 如 此 , 那 干 嘛 还 要 多 做 额外 的 工作 呢 ?” 如 果 不 用 编写 和 维护 额外 的 配置 代码 也 行 , 那 何必 还 
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要 它们 呢 ? 

大 多 数 情况 下 ， 自 动 配置 的 Bean 刚 好 能 满足 你 的 需要 ， 不 需要 去 覆盖 它们 。 但 某 些 情况 下 ， 
Spring Boot 在 自动 配置 时 还 不 能 很 好 地 进行 推断 。 

这 里 有 个 不 错 的 例子 : 当 你 在 应 用 程序 里 添加 安全 特性 时 ， 自 动 配置 做 得 还 不 够 好 。 安 全 配 
置 并 不 是 放 之 四 海 而 错 准 的 ， 围 绕 应 用 程序 安全 有 很 多 决策 要 做 ，Spring Boot 不 能 替 你 做 决定 。 
虽然 Spring Boot 为 安全 提供 了 一 些 基 本 的 自动 配置 , 但 是 你 还 是 需要 自己 覆盖 一 些 配置 以 满足 特 
定 的 安全 要 求 。 

想 知 道 如 何 用 显 式 的 配置 来 覆盖 自动 配置 ， 我 们 先 从 为 阅读 列表 应 用 程序 添加 Spring 
Security 和 信 手 。 在 了 解 自动 配置 提供 了 什么 之 后 ， 我 们 再 来 覆盖 基础 的 安全 配置 ， 以 满足 特定 的 



































3.4.1. 保护 应 用 程序 


Spring Boot 自 动 配置 让 应 用 程序 的 安全 工作 变 得 易如反掌 ， 你 要 做 的 只 是 添加 Security 起 步 
依赖 。 以 Gradle 为 例 ， 应 添加 如 下 依赖 : 


compile("org.springframework.boot:spring-boot-starter-security") 


如 果 使 用 Maven， 那 么 你 要 在 项 目的 -dependencies> 块 中 加 入 如 下 <dependency>: 








<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-security«/artifactId» 
</dependency> 


这 样 就 搞定 了 ! 重新 构建 应 用 程序 后 运行 即 可 ， 现 在 这 就 是 一 个 安全 的 Web 应 用 程序 了 ! 
Security 起 步 依 赖 在 应 用 程序 的 Classpath 里 添加 了 Spring Secuirty ( 和 其 他 一 些 东西 )。Classpath 里 
有 Spring Security 后 ， 自 动 配置 就 能 介入 其 中 创建 一 个 基本 的 Spring Security 配 置 。 

试 着 在 浏览 器 里 打开 该 应 用 程序 ， 你 马上 就 会 看 到 HTTP 基 础 身份 验证 对 话 框 。 此 处 的 用 户 
名 是 user， 密 码 就 有 点 麻烦 了 。 密 码 是 在 应 用 程序 每 次 运行 时 随机 生成 后 写 入 日志 的 ， 你 需要 查 
找 日 志 消 息 〈 默 认 写 人 标准 输出 )， 找 到 此 类 内 容 : 

Using default security password: d9d8abe5-42b5-4f20-a32a-76ee3df658d9 

我 不 能 肯定 ， 但 我 猜 这 个 特定 的 安全 配置 并 不 是 你 的 理想 选择 。 首 先 ，HTTP 基 础 身份 验证 
对 话 框 有 点 粗糙 ， 对 用 户 并 不 友好 。 而 且 , 我 敢 打 赌 你 一 般 不 会 开发 这 种 只 有 一 个 用 户 的 应 用 程 
序 ， 而 且 他 还 要 从 日 志文 件 里 找到 自己 的 密码 。 因 此 ， 你 会 希望 修改 Spring Security 的 一 些 配置 ， 
至 少 要 有 一 个 好 看 一 些 的 登录 页 ， 还 要 有 一 个 基于 数据 库 或 LDAP ( Lightweight Directory Access 
Protocol ) 用 户 存储 的 身份 验证 服务 。 

让 我 们 看 看 如 何 写 出 Spring Secuirty 配 置 ， 覆 盖 自 动 配 置 的 安全 设置 吧 。 
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3.1.2 ”创建 自 定义 的 安全 配置 


覆盖 自动 配置 很 简单 ,就 当 自动 配置 不 存在 ,直接 显 式 地 写 一 段 配 置 。 这 段 显 式 配置 的 形式 
不 限 ，Spring 支 持 的 XML 和 Groovy 形 式 配 置 都 可 以 。 

在 编写 显 式 配置 时 ,我 们 会 专注 于 Java 形 式 的 配置 。 在 Spring Security 的 场景 下 ,这 意味 着 写 
一 个 扩展 了 WebsecurityCconfigurerAdapter 的 配置 类 。 代码 清单 3-1 中 的 securityConfig 
就 是 我 们 需要 的 东西 。 


代码 清单 3-1 禾 盖 自动 配置 的 显 式 安全 配置 


package readinglist; 















































import org.springframework.beans.factory.annotation.Autowired; 

import org.springframework.context.annotation.Configuration; 

import org.springframework.security.config.annotation.authentication. 
builders.AuthenticationManagerBuilder; 
import org.springframework.security.config.annotation.web.builders. 
HttpSecurity; 
import org.springframework.security.config.annotation.web.configuration. 
EnableWebSecurity; 

import org.springframework.security.config.annotation.web.configuration. 
WebSecurityConfigurerAdapter; 
import org.springframework.security.core.userdetails.UserDetails; 

import org.springframework.security.core.userdetails.UserDetailsService; 














import org.springframework.security.core.userdetails. 
UsernameNotFoundException; 


GConfiguration 
GEnableWebSecurity 
public class SecurityConfig extends WebSecurityConfigurerAdapter { 


GAutowired 
private ReaderRepository readerRepository; 


GOverride 
protected void configure(HttpSecurity http) throws Exception ( 
http 


X z 
.authorizeRequests() Acn 
.antMatchers("/").access("hasRole('READER')") E 
.antMatchers("/**").permitAll() 
.and() 
设置 登录 表单 
.formLogin() 


的 路 径 
.loginPage("/login") ms 


.failureUrl("/login?error-true"); 
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QGOverride 
protected void configure( 
AuthenticationManagerBuilder auth) throws Exception ( 
auth 

.userDetailsService(new UserDetailsService() ( 
定义 自 定 义 
GOverride UserDetailsService 
public UserDetails loadUserByUsername(String username) 

throws UsernameNotFoundException { 


return readerRepository.findOne (username); 























SecurityConfig 是 个 非常 基础 的 Spring Security 配 置 , 尽管 如 此 , 它 还 是 完成 了 不 少 安 全 定 
制 工作 。 通 过 这 个 自 定义 的 安全 配置 类 ， 我们 让 Spring Boot 跳 过 了 安全 自动 配置 ， 转 而 使 用 我 们 
的 安全 配置 。 

扩展 了 WebSecurityConfigurerAdapter 的 配置 类 可 以 覆盖 两 个 不 同 的 conf igure() Jr 
ik, fESecurityConfigHi, £&—"l configure 0JriEd48HH, "/" (ReadingListController 
的 方法 映射 到 了 该 路 径 ) 的 请 求 只 有 经 过 身份 认证 且 拥 有 READER 角 色 的 用 户 才能 访问 。 其 他 的 
所 有 请 求 路 径 向 所 有 用 户 开 放 了 访问 权限 。 这 里 还 将 登录 页 和 登录 失败 页 ( 带 有 一 个 error 属 性 ) 

间 定 到 了 /login。 

Spring Security 为 身份 认证 提供 了 众多 选项 ， 后 端 可 以 是 JDBC ( Java Database Connectivity )、 
LDAP 和 内 存 用 户 存储 。 在 这 个 应 用 程序 中 ， 我 们 会 通过 JPA 用 数据 库 来 存储 用 户 信 息 。 第 二 个 
configure() 方 法 设置 了 一 个 自 定义 的 UserDetailsService， 这 个 服务 可 以 是 任意 实现 了 
UserDetailsServic 的 类 , 用 于 查找 指定 用 户 名 的 用 户 o 代码 清单 3-2 提 供 了 一 个 匿名 内 部 类 
实现 ,简单 地 调用 了 注入 ReaderRepository( 这 是 一 个 Spring Data JPA 仓 库 接口 ) 的 findone () 
方法 。 


代码 清单 3-2 用 来 持久 化 读者 信息 的 仓库 接口 


package readinglist; 

































































import org.springframework.data.jpa.repository.JpaRepository; 
public interface ReaderRepository 通过 JPA 持 
， a | 久 化 读者 
extends JpaRepository«Reader, String» ( 

j 

和 BookRepository 类 似 ， 你 无 需 自 己 实现 ReaderRepository。 这 是 因为 它 扩展 了 
JpaRepository, Spring Data JPA 会 在 运行 时 自动 创建 它 的 实现 。 这 为 你 提供 了 18 个 操作 Reader 
实体 的 方法 。 

说 到 Reader 实 体 ，Reader 类 ( 如 代码 清单 3-3 所 示 ) 就 是 最 后 一 块 拼 图 了 ， 它 就 是 一 个 简 
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单 的 JPA 实 体 ， 其 中 有 几 个 字段 用 来 存储 用 户 名 、 密 码 和 用 户 全 名 。 


代码 清单 3-3 ”定义 Reagder 的 JPA 实 体 
package readinglist; 
import java.util.Arrays; 
import java.util.Collection; 
import javax.persistence.Entity; 
import javax.persistence.Id; 


import org.springframework.security.core.GrantedAuthority; 
import org.springframework.security.core.authority.SimpleGrantedAuthority; 
import org.springframework.security.core.userdetails.UserDetails; 





GEntity 


public class Reader implements UserDetails ( 


private static final long serialVersionUID 


@Id 

private String username; 

private String fullname; Reader 字 段 
private String password; 


public String getUsername() { 
return username; 


public void setUsername(String username) 


this.username - username; 


public String getFullname() ( 
return fullname; 


public void setFullname(String fullname) 


this.fullname - fullname; 


public String getPassword() ( 
return password; 


public void setPassword(String password) 


this.password - password; 


// UserDetails methods 


GOverride 


1L; 


public Collection«? extends GrantedAuthority» getAuthorities() ( < 一 
return Arrays.asList(new SimpleGrantedAuthority ("READER")); 


授予 READER 
权限 
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GOverride 
public boolean isAccountNonExpired() ( < 二 一 一 
return true; 


) 


GOverride 
public boolean isAccountNonLocked() { I 
return true; 
} 不 过 期 , 不 加 锁 ， 
不 禁用 
GOverride 


public boolean isCredentialsNonExpired() {<- —— ———— 
return true; 


) 


GOverride 
public boolean isEnabled() ( q 
return true; 


} 
} 


如 你 所 见 ，Reagder 用 了 @Entity 注 解 ， 所 以 这 是 一 个 JPA 实 体 。 此 外 ， 它 的 username 字 上 段 
上 有 QId 注 解 ， 表 明 这 是 实体 的 DD。 这 个 选择 无 可 厚 非 ， 因 为 username 应 该 能 唯一 标识 一 个 
Readers 

你 应 该 还 注意 到 Reader 实 现 了 UserDetails 接 口 以 及 其 中 的 方法 ， 这 样 Reader 就 能 代表 
Spring Security 里 的 用 户 了 。getAuthorities () 方 法 被 覆盖 过 了 ， 始 终 会 为 用 户 授予 READER 
权限 。isAccountNonExpired()、isAccountNonLocked() 、 iscredqentialsNonExpired() 
fllisEnabled () 方 法 都 返回 true， 这 样 读者 账户 就 不 会 过 期 ， 不 会 被 锁定 ， 也 不 会 被 撤销 

重新 构建 并 重启 应 用 程序 后 ， 你 应 该 就 能 以 读者 身份 登录 应 用 程序 了 。 

保持 简单 ”在 一 个 大 型 应 用 程序 里 ， 赋 予 用 户 的 授权 本 身 也 可 能 是 实体 ， 它 们 被 

维护 在 独立 的 数据 表 里 。 同 样 ， 表示 一 个 账户 是 否 为 非 过 期 、 非 锁定 且 可 用 的 布尔 值 也 

是 数据 库 里 的 字段 。 但 是 ， 出 于 演示 考虑 ， 我 决定 让 这 些 细节 保持 简单 ， 以 免 分 散 我 们 

的 注意 力 ， 影 响 正 在 讨论 的 话题 一 我 说 的 是 履 盖 Spring Boot 自 动 配置 。 

在 安全 配置 方面 ， 我 们 还 能 做 更 多 事情 "， 但 此 刻 这 样 就 足够 了 ， 上 面 的 例子 足以 演示 如 何 
履 盖 Spring Boot 提 供 的 安全 自动 配置 。 
再 重申 一 次 ， 想 要 覆盖 Spring Boot 的 自动 配置 ， 你 所 要 做 的 仅仅 是 编写 一 个 显 式 的 配置 。 
Spring Boot 会 发 现 你 的 配置 ， 随 后 降低 自动 配置 的 优先 级 ， 以 你 的 配置 为 准 。 想 弄 明 白 这 是 如 何 
实现 的 ， 让 我 们 揭 开 Spring Boot 自 动 配置 的 神秘 面纱 ,看 看 它 是 如 何 运 作 的 ， 以 及 它 是 怎么 允许 
自己 被 覆盖 的 。 
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DHERA T fSpring Security， 可 以 参考 《Spring 实战 〈( 第 4 版 )》 中 的 第 9 章 和 第 14 章 。 
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3.1.3， 掀 开 自 动 配置 的 神秘 面纱 


正如 我 们 在 2.3.3 节 里 讨论 的 那样 ，Spring Boot 自 动 配置 自 带 了 很 多 配置 类 ,每 一 个 都 能 运 
在 你 的 应 用 程序 里 。 它们 都 使 用 了 Spring 4.0 的 条 件 化 配置 , 可 以 在 运行 时 判断 这 个 配置 是 该 被 
用 ， 还 是 该 被 忽略 。 

大 部 分 情况 下 ， 表 2-1 里 的 econdqitionalonMissinoBean 注 解 是 覆盖 自动 配置 的 关键 。 
Spring Boot 的 DataSourceAutoConfiguration 中 定义 的 JdbcTemplate Bean 就 是 一 个 非常 简 
单 的 例子 ， 演 示 了 econaqitionalonMissingBean 如 何 工作 : 







































































GBean 
GConditionalOnMissingBean(JdbcOperations.class) 
public JdbcTemplate jdbcTemplate() ( 

return new JdbcTemplate(this.dataSource); 


} 

jdbcTemplate() 方 法 上 添加 了 @Bean 注 解 ， 在 需要 时 可 以 配置 出 一 个 JdbcTemplate 
Bean, 但 它 上 面 还 加 了 @CcongditionalonMissingBean 注 解 , 要 求 当前 不 存在 Jdbcoperations 
类 型 ( JdbcTemplate 实 现 了 该 接口 ) 的 Bean 时 才 生 效 。 如 果 当 前 已 经 有 一 个 Jdbcoperations 
Bean 了， 条 件 即 不 满足 ， 不 会 执行 jdbcTemplate() 方 法 。 

什么 情况 下 会 存在 一 个 Jdbcoperations Bean 呢 ? Spring Boot 的 设计 是 加 载 应 用 级 配置 , 随 
后 再 考虑 自动 配置 类 。 因 此 , 如果 你 已 经 配置 了 一 个 zabcTemplate Bean, 那么 在 执行 自动 配置 
时 就 已 经 存在 一 个 Jdbcoperations 类 型 的 Bean 了 ， 于 是 忽略 自动 配置 的 JdbcTemplate Bean, 

关于 Spring Security， 自 动 配置 会 考虑 几 个 配置 类 。 在 这 里 讨论 每 个 配置 类 的 细节 是 不 切实 
际 的 , 但 覆盖 Spring Boot 自 动 配置 的 安全 配置 时 , 最 重要 的 一 个 类 是 springBootWebSecurity- 
Configuration; 以 下 是 其 中 的 一 个 代码 片段 : 


@Configuration 

GEnableConfigurationProperties 

GConditionalOnClass(( EnableWebSecurity.class }) 
GConditionalOnMissingBean(WebSecurityConfiguration.class) 
GConditionalOnWebApplication 

public class SpringBootWebSecurityConfiguration { 
















































































} 

如 你 所 见 ，springBootwebSecurityConfiguration 上 加 了 好 几 个 注解 。 看 到 @Ccondi- 
tionalonClass 注 解 后 ， 你 就 应 该 知道 Classpath 里 必须 要 有 Q@EnableWebSecurity 注 解 。 
@ConditionalOonWebApplication 说 明 这 必须 是 个 Web 应 用 程序 。@Conditionalon- 
MissingBean 注 解 才 是 我 们 的 安全 配置 类 代替 SpringBootWwebSsecurityCconfiguration 的 关 
键 所 在 。 

econaitionalonMissingBean 注 解 要 求 当 下 没有 websecurityCconfiguration 类 型 的 
Bean。 虽 然 表 面 上 我 们 并 没有 这 么 一 个 Bean， 但 通过 在 securityconfig 上 添加 aeEnableweb- 
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Security 注 解 ， 我 们 实际 上 间接 创建 了 一 个 websecurityconfiguration Bean。 所 以 在 自动 
配置 时 ， 这 个 Bean 就 已 经 存在 了 ， econditionalonMissingBean 条 件 不 成 立 ， SpringBoot- 
WebSecurityConfiguration 提 供 的 配置 就 被 跳 过 了 。 

虽然 Spring Boot 的 自动 配置 和 econqitionalonMissingBean 让 你 能 显 式 地 覆盖 那些 可 以 
自动 配置 的 Bean, 但 并 不 是 每 次 都 要 做 到 这 种 程度 。 让 我 们 来 看 看 怎么 通过 设置 几 个 简单 的 配置 
辕 性 调整 自动 配置 组 件 吧 。 


3.2 通过 属性 文件 外 置 配置 


在 处 理应 用 安全 时 ， 你 当然 会 希望 完全 掌控 所 有 配置 。 不 过 ,为 了 微调 一 些 细节 ， 比 如 改 改 
端口 号 和 日 志 级 别 ， 便 放弃 自动 配置 ， 这 是 一 件 让 人 状 愧 的 事 。 为 了 设置 数据 库 URL ， 是 配置 一 
个 属性 简单 ， 还 是 完整 地 声明 一 个 数据 源 的 Bean 人 简单? 答案 不 言 自明 ， 不 是 吗 ? 

EKE, Spring Boot 自 动 配置 的 Bean 提 供 了 300 多 个 用 于 微调 的 属性 。 当 你 调整 设置 时 ， 
要 在 环境 变量 、Java 系 统 属性 、JNDI ( Java Naming and Directory Interface )、 命 令 行 参 数 或 者 
性 文件 里 进行 指定 就 好 了 。 

要 了 解 这 些 属性 ， 让 我 们 来 看 个 非常 简单 的 例子 。 你 也 许 已 经 注意 到 了 ,在 命令 行 里 运行 阅 
读 列表 应 用 程序 时 ，Spring Boot 有 一 个 ascii-art Banner。 如 果 你 想 禁用 这 个 Banner， 可 以 将 
spring .main.show-banner 属 性 设置 为 false。 有 几 种 实现 方式 , 其 中 之 一 就 是 在 运行 应 用 程 
序 的 命令 行 参数 里 指定 : 

$ java -jar readinglist-0.0.1-SNAPSHOT.jar --spring.main.show-banner-false 

男 一 种 方式 是 创建 一 个 名 为 application.properties 的 文件 ， 包 含 如 下 内 容 : 

spring.main.show-banner=false 


或 者 ， 如 果 你 喜欢 的 话 ， 也 可 以 创建 名 为 application.yml 的 YAMIL 文 件 ， 内 容 如 下 : 
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spring: 
main: 
show-banner: false 


还 可 以 将 属性 设置 为 环境 变量 。 举 例 来 说 ， 如 果 你 用 的 是 bash 或 者 zsh， 可 以 用 export 命 令 : 
$ export spring main, show banner-false 
请 注意 ， 这 里 用 的 是 下 划 线 而 不 是 点 和 横 杠 ， 这 是 对 环境 变量 名 称 的 要 求 。 
实际 上 ，Spring Boot 应 用 程序 有 多 种 设置 途径 。Spring Boot 能 从 多 种 属性 源 获得 属性 ， 包 括 
如 下 几 处 。 












































(1) 命令 行 参数 
(2) java:comp/env 里 的 JNDI 属 性 
(3) JVM 系 统 属性 


(4) 操作 系统 环境 变量 
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(5) 随机 生成 的 带 xandom.* 前 级 的 属性 ( 在 设置 其 他 属性 时 ,可 以 引用 它们 ,比如 $ {random. 
long)) 

(6) 应 用 程序 以 外 的 application.properties 或 者 appliaction.yml 文 件 

(7) 打包 在 应 用 程序 内 的 application.properties 或 者 appliaction.yml 文 件 

(8) 通过 ePropertySource 标 注 的 属性 源 

(9) 默认 属性 

这 个 列表 按照 优先 级 排序 , 也 就 是 说 , 任何 在 高 优先 级 属性 源 里 设置 的 属性 都 会 覆盖 低 优先 
级 的 相同 属性 。 例 如 ， 命 令 行 参数 会 覆盖 其 他 属性 源 里 的 属性 。 

application.properties 和 application.yml 文 件 能 放 在 以 下 四 个 位 置 。 

(1) 外 置 ， 在 相对 于 应 用 程序 运行 目录 的 /config 子 目录 里 。 

(2) 外 置 ， 在 应 用 程序 运行 的 目录 里 。 

(3) 内 置 ， 在 config 包 内 。 

(4) 内 置 ， 在 Classpath 根 目录 。 

同样 ， 这 个 列表 按照 优先 级 排序 。 也 就 是 说 ，/config 子 目录 里 的 application.properties 会 覆盖 
应 用 程序 Classpath 里 的 application.properties 中 的 相同 属性 。 

此 外 ,如 果 你 在 同一 优先 级 位 置 同 时 有 application.properties 和 application.yml ,那么 application. 
yml 里 的 属性 会 覆盖 application.properties 里 的 属性 。 

禁用 ascii-art Banner 只 是 使 用 属性 的 一 个 小 例子 。 让 我 们 再 看 几 个 例子 ， 看 看 如 何 通过 常用 
途径 微调 自动 配置 的 Bean。 


3.2.1 自动 配置 微调 


如 上 所 说 ,有 300 多 个 属性 可 以 用 来 微调 Spring Boot 应 用 程序 里 的 Bean。 附 录 C 有 一 个 详尽 的 
列表 。 此 处 无 法 逐一 描述 它们 的 细节 ， 因 此 我 们 就 通过 几 个 例子 来 了 解 一 些 Spring Boot 暴 露 的 实 
用 属性 。 

1. 禁用 模板 缓存 

如 果 阅 读 列表 应 用 程序 经 过 了 几 番 修改 , 你 一 定 已 经 注意 到 了 ,除非 重启 应 用 程序 ， 否则 对 
Thymeleaf 模 板 的 变更 是 不 会 生效 的 。 这 是 因为 Thymeleaf 异 板 默 认 缓 存 。 这 有 助 于 改善 应 用 程序 
的 性 能 ， 因 为 模板 只 需 编 译 一 次 ， 但 在 开发 过 程 中 就 不 能 实时 看 到 变更 的 效果 了 。 

将 spring.thymeleaf.cache 设 置 为 false 就 能 禁用 Thymeleaf 模 板 缓存 。 在 命令 行 里 运行 
应 用 程序 时 ， 将 其 设置 为 命令 行 参数 即 可 : 

$ java -jar readinglist-0.0.1-SNAPSHOT.jar --spring.thymeleaf.cache-false 


或 者 ， 如 果 你 希望 每 次 运行 时 都 禁用 缓存 ， 可 以 创建 一 个 application.yml， 包 含 以 下 内 容 : 


spring: 
thymeleaf: 
cache: false 
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你 一 定 要 确保 这 个 文件 不 会 发 布 到 生产 环境 , 否则 生产 环境 里 的 应 用 程序 就 无 法 享受 模板 组 
存 带 来 的 性 能 提升 了 。 

作为 开发 者 ， 在 修改 模板 时 始终 关闭 缓存 实在 太 方便 了 。 为 此 ， 可 以 通过 环境 变量 来 禁用 
Thymeleaf 缓 存 : 





$ export spring thymeleaf cache-false 
此 处 使 用 Thymeleaf 作 为 应 用 程序 的 视图 ，Spring Boot 支 持 的 其 他 模板 也 能 关闭 模板 缓存 ， 
设置 这 些 属 性 就 好 了 : 


口 spring.freemarker.cache (Freemarker ) 








口 spring.groovy.template.cache (Groovy 模 板 ) 











U spring.velocity.cache (Velocity ) 

默认 情况 下 ， 这 些 属性 都 为 crue， 也 就 是 开启 缓存 。 将 它们 设置 为 false 即 可 禁用 缓存 。 

2. 配置 能 入 式 服 务 器 

从 命令 行 (或 者 Spring Tool Suite ) 运行 Spring Boot 应 用 程序 时 ， 应 用 程序 会 启动 一 个 怠 和 人 式 
的 服务 器 〈 默 认 是 Tomcat )， 监 听 8080 端 口 。 大 部 分 情况 下 这 样 插 好， 但 同时 运行 多 个 应 用 程序 
可 能 会 有 问题 。 要 是 所 有 应 用 程序 都 试 着 让 Tomecat 服 务 器 监听 同一 个 端口 , 在 启动 第 二 个 应 用 程 
序 时 就 会 有 冲突 。 

无 论 出 于 什么 原因 ， 让 服务 器 监听 不 同 的 端口 ， 你 所 要 做 的 就 是 设置 server .port 属 性 。 
要 是 只 改 一 次 ， 可 以 用 命令 行 参 数 : 

$ java -jar readinglist-0.0.1-SNAPSHOT.jar --server.port-8000 

但 如 果 和 希望 端口 变更 时 间 更 长 一 点 ， 可 以 在 其 他 支持 的 配置 位 置 上 设置 server .port。 例 
如 ， 把 它 放 在 应 用 程序 Classpath 根 目录 的 application.yml 文 件 里 : 


server: 
port: 8000 


除了 服务 器 的 端口 ， 你 还 可 能 希望 服务 器 提供 HTTPS 服 务 。 为 此 ， 第 一 步 就 是 用 JDK 的 
keytool 工 具 来 创建 一 个 密 钥 存储 (keystore ): 

$ keytool -keystore mykeys.jks -genkey -alias tomcat -keyalg RSA 

该 工具 会 询问 几 个 与 名 字 和 组 织 相 关 的 问题 ,大 部 分 都 无 关 紧 要 。 但 在 被 问 到 密码 时 ,一定 
要 记 住 你 的 选择 。 在 本 例 中 ， 我 选择 letmein 作 为 密码 。 

现在 只 需要 设置 几 个 属性 就 能 开启 能 人 式 服务 器 的 HTTPS 服 务 了 。 可 以 把 它们 都 配置 在 命令 
行 里 ， 但 这 样 太 不 方便 了 。 可 以 把 它们 放 在 application.properties 或 application.yml 里 。 在 
application.yml 中 ， 它 们 可 能 是 这 样 的 : 





























































































































server: 
port: 8443 
ssl: 
key-store: file:///path/to/mykeys.jks 
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key-store-password: letmein 
key-password: letmein 


此 处 的 server.port 设 置 为 8443 ， 开 发 环境 的 HITPS 服 务 需 大 多 会 选 这 个 端口 。 
server.ss]1.key-store 属 性 指向 密 钥 存 储 文件 的 存放 路 径 。 这 里 用 了 一 个 file:/ 开 头 的 URL， 
从 文件 系统 里 加 载 该 文件 。 你 也 可 以 把 它 打 包 在 应 用 程序 的 JAR 文 件 里 ， 用 classpath: URLÆ 
引用 它 。server .ssl. key-store-pas swordflserver.ssl. key-pas sword 设 置 为 创建 该 文 
件 时 给 定 的 密码 。 

有 了 这 些 属性 ， 应 用 程序 就 能 在 8443 端 口上 监听 HTTPS 请 求 了 。( 根据 你 所 用 的 浏览 器 ， 可 

bE 会 出 现 警 告 框 提示 该 服务 器 无 法 验证 其 身份 。 在 开发 时 ,访问 的 是 localhost， 这 没什么 好 担心 
的 。) 

3. 配置 日 志 

大 多 数 应 用 程序 都 提供 了 某 种 形式 的 日 志 。 即 使 你 的 应 用 程序 不 会 直接 记录 日 志 , 你 所 用 的 
库 也 会 记录 它们 的 活动 。 
默认 情况 下 ，Spring Boot 会 用 Logback ( http://logback.qos.ch ) 来 记录 日 志 ， 并 用 INFO 级 别 输 
出 到 控制 台 。 在 运行 应 用 程序 和 其 他 例子 时 ， 你 应 该 已 经 看 到 很 多 INFo 级 别 的 日 志 















































用 其 他 日 志 实 现 替 换 Logback 

一 般 来 说 ， 你 不 需要 切换 日 志 实 现 ; Logback 能 很 好 地 满足 你 的 需要 。 但 是 ， 如 果 决 定 使 
用 Log 和 或 者 Log4 和 ji 2， 那 么 你 只 需要 修改 依赖 ， 引 入 对 应 该 日 志 实 现 的 起 步 依赖 ， 同 时 排除 掉 
Logback。 

以 Maven 为 例 ， 应 排除 掉 根 起 步 依 赖 传 递 引 入 的 默认 日志 起 步 依 赖 ， 这 样 就 能 排除 
Logback 7 : 


<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter«/artifactId» 
«exclusions» 

«exclusion» 
«groupId»org.springframework.boot«/groupId» 
«artifactlId»spring-boot-starter-logging«/artifactId» 

«/exclusion» 

«/exclusions» 
</dependency> 


在 Gradle 里 ， 在 configurations 下 排除 该 起 步 依 赖 是 最 简单 的 办 法 : 


configurations ( 
all*.exclude group:'org.springframework.boot', 
module:'spring-boot-starter-logging' 


D 


排除 默认 日志 的 起 步 依 赖 后 ， 就 可 以 引入 你 想 用 的 日 志 实 现 的 起 步 依 赖 了 。 在 Maven 里 可 
以 这 样 添加 Log4j: 
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<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-log4j«/artifactId» 
</dependency> 


在 Gradle 里 可 以 这 样 添加 Log4j: 


compile("org.springframework.boot:spring-boot-starter-109g4j") 





如 果 你 想 用 Log4j2， 可 以 把 spring-boot-starter-log4j 改 成 spring-boot-starter-log4j2。 
要 完全 掌握 日 志 配 置 ， 可 以 在 Classpath 的 根 目录 ( src/main/resources ) 里 创建 logback.xml 文 
件 。 下 面 是 一 个 logback.xml 的 简单 例子 : 


<configuration> 


<appender name-"STDOUT" class="ch.qos.logback.core.ConsoleAppender"> 
<encoder> 


<pattern> 
sd{HH:mm:ss.SSS} [$thread] %-5level %šlogger{36} - $msg$n 
</pattern> 
</encoder> 
</appender> 








<logger name="root" level="INFO"/> 


<root level="INFO"> 
<appender-ref ref="STDOUT" /> 
</root> 
</configuration> 


除了 日 志 格 式 之 外 ， 这 个 Logback 配 置 和 不 加 logback.xml 文 件 的 默认 配置 差不多 。 但 是 ， 通 
过 编辑 logback.xml， 你 可 以 用 程序 的 日 志文 件 。 哪 些 配 置 应 该 放 进 logback.xml 这 个 话 
题 不 在 本 书 的 讨论 范围 内 ， 请 参考 Logback 的 文档 以 了 解 更 多 信息 。 

即使 如 此 ， 你 对 日 志 E EA A 日 志 级 别 和 指定 日 志 输 出 的 文件 。 使 用 了 
Spring Boot 的 配置 属性 后 ， 你 可 以 在 不 创建 logback.xml 文 件 的 情况 下 修改 那些 配置 。 

要 设置 日 志 级 别 ， 你 可 以 创建 以 logging.leve1 开 头 的 属性 ， 后 面 是 要 日 志 名 称 。 如 果 根 

日 志 级 别 要 设置 为 WARN， 但 Spring Security 的 日 志 要 用 DEBUG 级 别 ， 可 以 在 application.yml 里 加 入 
以 下 内 容 : 





































































































logging: 
level: 
root: WARN 
org: 
springframework: 


Security: DEBUG 
另外 ， 你 也 可 以 把 Spring Security 的 包 名 写成 一 行 : 


logging: 
level: 
root: WARN 
org.springframework.security: DEBUG 
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现在 ， 假 设 你 想 把 日 志 写 到 位 于 /varlogs/ 目 录 里 的 BookWorm.log 文 件 里 。 使 用 logging. 
path 和 1oggin .file 属 性 就 行 了 ， 








logging: 
path: /var/logs/ 
file: BookWorm.log 


level: 
root: WARN 
org: 
springframework: 


security: DEBUG 
假设 应 用 程序 有 /var/logs/ 的 写 权 限 ， 日 志 就 能 被 写 人 /var/logs/BookWorm.log。 默 认 情 况 下 ， 
日 志文 件 的 大 小 达到 10MB 时 会 切 分 一 次 。 
与 之 类 似 ， 这 些 属性 也 能 在 application.properties 里 设置 : 








logging.path=/var/logs/ 

logging.file-BookWorm.log 

logging.level.root-WARN 
logging.level.root.org.springframework.security-DEBUG 


如 果 你 还 是 想 要 完全 掌控 日 志 配 置 ， 但 是 又 不 想 用 logback.xml 作 为 Logback 配 置 的 名 字 ， 可 
以 通过 logging.config 属 性 指定 自 定 义 的 名 字 


















































logging: 
config: 
classpath:logging-config.xml 


虽然 一 般 并 不 需要 改变 配置 文件 的 名 字 , 但 是 如 果 你 想 针对 不 同 运行 时 Profile 使 用 不 同 的 日 
志 配 置 ( 见 3.2.3 节 )， 这 个 功能 会 很 有 用 。 

4. 配置 数据 源 

此 时 ， 我 们 还 在 开发 阅读 列表 应 用 程序 ， 瞬 入 式 的 H2 数 据 库 能 很 好 地 满足 我 们 的 需要 。 可 
是 一 旦 要 投放 到 生产 环境 ,我 们 可 能 要 考虑 更 持久 的 数据 库 解 决 方案 。 

虽然 你 可 以 显 式 配 置 自己 的 DataSource Bean, 但 通常 并 不 用 这 么 做 , 只 需 简 单 地 通过 属性 
配置 数据 库 的 URL 和 身份 信息 就 可 以 了 。 举 例 来 说 ， 如 果 你 用 的 是 MySQL 数 据 库 ， 你 的 
application.yml 文 件 看 起 来 可 能 是 这 样 的 : 



















































































spring: 
datasource: 
url: jdbc:mysql://localhost/readinglist 
username: dbuser 
password: dbpass 


通常 你 都 无 需 指定 JDBC 驱 动 ，Spring Boot 会 根据 数据 库 URL 识 别 出 需 要 的 驱动 ， 但 如 果 识 


别 出 问 题 了 ,你 还 可 以 设置 spring .datasource.driver-class-name 属 性 : 

















spring: 
datasource: 
url: jdbc:mysql://localhost/readinglist 


邮 
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username: dbuser 
password: dbpass 
driver-class-name: com.mysgl.jdbc.Driver 


在 自动 配置 Datasource Bean 的 时 候 ，Spring Boot 会 使 用 这 里 的 连接 数据 。Datasource 
Bean 是 一 个 连接 池 , 如 果 Classpath 里 有 Tomcat 的 连接 池 Datasource, 那么 就 会 使 用 这 个 连接 池 ; 
否则 ，Spring Boot 会 在 Classpath 里 查找 以 下 连接 池 : 

口 HikariCP 
Q Commons DBCP 
口 Commons DBCP 2 

这 里 列 出 的 只 是 自动 配置 支持 的 连接 池 , 你 还 可 以 自己 配置 Datasource Bean, 使 用 你 喜欢 
的 各 种 连接 池 。 

你 也 可 以 设置 spring .datasource.jnqdi-name 属 性 ， 从 JNDI 里 查找 DataSource: 











spring: 
datasource: 
jndi-name: java:/comp/env/jdbc/readingListDS 


一 旦 设置 了 spring.dqatasource.jndqi-name 属 性 ， 其 他 数据 源 连 接 属 性 都 会 被 忽略 ， 除 
非 没 有 设置 别 的 数据 源 连 接 属性 。 

有 很 多 影响 Spring Boot 自 动 配置 组 件 的 方法 ， 只 需 设 置 一 两 个 属性 即 可 。 但 这 种 配置 外 置 的 
方法 并 不 局 限于 Spring Boot 配 置 的 Bean。 让 我 们 看 看 如 何 使 用 这 种 属性 配置 机 制 来 微调 自己 的 应 
用 程序 组 件 。 


3.22 ”应 用 程序 Bean 的 配置 外 置 


假设 我 们 在 某 人 的 阅读 列表 里 不 止 想 要 展示 图 书 标题 ， 还 要 提供 该 书 的 Amazon 链 接 。 我 们 
不 仅 想 提供 该 书 的 链接 ， 还 要 标记 该 书 ， 以 便利 用 Amazon 的 Associate Program， 这 样 如 果 有 人 用 
我 们 应 用 程序 里 的 链接 买 了 书 ， 我 们 还 能 收 到 一 笔 推 荐 费 。 

这 很 人 简单， 只 需 修改 Thymeleaf 异 板 ， 以 链接 的 形式 来 呈现 每 本 书 的 标题 就 可 以 了 : 

«a th:hrefz"'http://www.amazon.com/gp/product/' 

* $(book.isbn) 


+ '/tag-habuma-20'" 
th:text-"$(book.title)"»Title«/a» 


这 样 就 好 了 。 现在 如 果 有 人 点 击 该 链接 并 购买 了 本 书 , 我 就 能 得 到 推荐 费 了 , 因为 habuma- " 
是 我 的 Amazon Associate ID。 如 果 你 也 想 收 到 推荐 费 ， 可 以 把 Thymeleaf 异 板 中 tag 的 值 改 成 你 
Amazon Associate ID。 

虽然 在 模板 里 修改 这 个 值 很 简单 ， 但 这 上 毕竟 也 是 硬 编码 。 现 在 只 在 一 个 模板 里 链接 到 
Amazon， 但 后 续 可 能 会 有 更 多 页 面 链接 到 Amazon， 于 是 需要 为 应 用 程序 添加 功能 。 那 样 的 话 ， 
修改 Amazon Associate ID 就 要 改动 好 几 个 地 方 。 因 此 ， 这 种 细节 最 好 不 要 放 在 代码 里 ， 要 把 它们 
集中 在 一 个 地 方 维护 。 





















































56 $33 自 定义 配置 








我 们 可 以 不 在 模板 里 硬 编码 Amazon Associate ID ， 而 是 把 它 变 成 模型 中 的 一 个 值 : 


«a th:href-"'http://www.amazon.com/gp/product/' 
+ $(book.isbn) 
+ '/tag-' + S$(amazonID)" 
th:text-"$(book.title)"»Title«/a» 


此 外 ，ReaqaingListcontroller 需 要 在 模型 里 包含 amazonID 这 个 键 ， 其 中 的 内 容 是 
Amazon Associate ID 。 同 样 的 道理 ， 我 们 不 应 该 硬 编码 这 个 值 ， 而 是 应 该 引用 一 个 实例 变量 。 这 
个 变量 的 值 应 该 来 自 属 性 配置 。 代 码 清单 3-4 就 是 新 的 ReadingListcontroller， 它 会 返回 注 
人 的 Amazon Associate ID. 












































"uni 


代码 清单 3-4 ”修改 后 的 ReadingListcontroller， 能 接受 Amazon ID 


package readinglist; 





import java.util.List; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.context.properties.ConfigurationProperties; 
import org.springframework.stereotype.Controller; 
import org.springframework.ui.Model; 
import org.springframework.web.bind.annotation.RequestMapping; 
import org.springframework.web.bind.annotation.RequestMethod; 
@Controller » 
GRequestMapping("/") 属性 注入 
GConfigurationProperties(prefix-"amazon") < 一 
public class ReadingListController ( 

private String associateId; 

private ReadingListRepository readingListRepository; 

GAutowired 

public ReadingListController( 

ReadingListRepository readingListRepository) ( 
this.readingListRepository - readingListRepository; 
) associateId 
; c l l 的 setter 方 法 
public void setAssociateId(String associateId) ( 
this.associateId = associateld; 





GRequestMapping (method-RequestMethod.GET) 

public String readersBooks (Reader reader, 
List«Book» readingList - 

readingListRepository.findByReader (reader); 


Model model) { 


if (readingList !- null) ( 
model.addAttribute("books", readingList); 
model.addAttribute("reader", reader); 将 associated 


model.addAttribute("amazonID", associateId); a 放 入 模型 
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return "readingList"; 


) 


GRequestMapping (method-RequestMethod.POST) 

public String addToReadingList(Reader reader, Book book) ( 
book.setReader(reader); 
readingListRepository.save (book); 
return "redirect:/"; 


F 
} 


如 你 所 见 ，ReadingListcontroller 现 在 有 了 一 个 associateIgd 属 性 ， 还 有 对 应 的 set- 
AssociateId() 方 法 , 用 它 可 以 设置 该 属性 。readersBooks () 现在 能 通过 amazonID 这 个 键 把 
associateIgd 的 值 放 入 模型 。 

ERT! 现在 就 剩 一 个 问题 了 一 一 从 哪里 能 取 到 associateId 的 值 。 

请 注意 ， ReadingListController 上 加 了 @ConfigurationProperties 注 解 ， 这 说 明 该 
Bean 的 属性 应 该 是 ( 通过 setter 方 法 ) 从 配置 属性 值 注 和 人 的 。 说 得 更 具体 一 点 ，prefix 属 性 说 明 
ReadingListController 应 该 注入 带 amazon 前 级 的 属性 。 

综合 起 来 ， 我 们 指定 ReadingListcontroller 的 属性 应 该 从 带 amazon 前 缀 的 配置 属性 中 
进行 注入 。ReaaqingListcontroller 只 有 一 个 setter 方 法 ,就 是 设置 associateIdq 属 性 用 的 setter 
方法 。 因 此 , 设置 Amazon Associate ID 唯一 要 做 的 就 是 添加 amazon.associateId 属 性 ,把 它 加 
人 支持 的 任 一 属性 源 位 置 里 即 可 。 

例如 ， 我 们 可 以 在 application.properties 里 设置 该 




































































性 : 


38] 


amazon.associateId-habuma-20 
或 者 在 application.yml 里 设置 ; 


amazon : 
associateld: habuma-20 


或 者 , 我 们 可 以 将 其 设置 为 环境 变量 , 把 它 作为 命令 行 参 数 , 或 把 它 加 到 任何 能 够 设置 配置 属 
的 地 方 。 

















性 














N 








开启 配置 属性 从 技术 上 来 说 ，econfigurationProperties 注 解 不 会 生效 ， 除 

非 先 向 Spring 配置 类 添加 eEnableconfigurationPropetrties 注 解 。 但 通常 无 需 这 人 么 

做 ， 因 为 Spring Boot 自 动 配置 后 面 的 全 部 配置 类 都 已 经 加 上 了 @EnableConfigura- 

tionProperties 注 解 。 因 此 ， 除 非 你 完全 不 使 用 自动 配置 ( 那 怎么 可 能 ? )， 否 则 就 

无 需 显 式 地 添加 aeEnableconfigurationProperties。 

还 有 一 点 需要 注意 ，Spring Boot 的 属性 解析 器 非常 智能 ， 它 会 自动 把 驼峰 规则 的 属性 和 使 用 
连 字 符 或 下 划 线 的 同名 属性 关联 起 来 。 换 句 话 说 ，amazon.associateId 这 个 属性 和 
amazon.associate_idq 以 及 amazon.associate-id 都 是 等 价 的 。 用 你 习惯 的 命名 规则 就 好 。 
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在 一 个 类 里 收集 属性 
虽然 在 ReadingListCcontroller 上 加 上 econfigurationProperties 注 解 跑 起 来 没 问 


题 ， 但 这 并 不 是 一 个 理想 的 方案 。 








前 级 却 是 amazo 


Controller 里 新 增 配 置 











ReadingListController 和 Amazon 没 什么 关系 ， 但 属性 的 














n， 这 看 起 来 难道 不 奇怪 吗 ? 再 说 ， 后 续 的 各 种 功能 可 能 需要 在 ReadingList- 
属性 ， 而 它们 和 Amazon 无 关 。 




















与 其 在 ReadingListcontroller 里 加 载 配 置 属性 , 还 不 如 创建 一 个 单独 的 Bean, 为 它 加 上 
@ConfigurationProperties 注 解 , 让 这 个 Bean 收 集 所 有 配置 属性 。 代码 清单 3-5 里 的 Amazon- 
Properties 就 是 一 个 例子 ， 它 用 于 加 载 Amazon 相 关 的 配置 属性 。 


代码 清单 3-5 “在 一 个 Bean 里 加 载 配置 属性 


package readinglist; 


























import org.springframework.boot.context.properties. 


ConfigurationProperties; 


import org.springframework.stereotype.Component; 


GComponent 
econ figurat tonpropert ies amazorit) 3— — 注入 带 amazon 
public class AmazonProperties { 前 缀 的 属性 


private String associateId; 


public void setAssociateId(String associateld) ( < 一 一 
this.associateId = associateIld; 


} 


associateld 的 
setter 方 法 


public String getAssociateId() ( 
return associateld; 


} 


} 








有 了 加 载 amazon.associateId 配 置 属性 的 AmazonProperties 后 ， 我 们 可 以 调整 
ReadingListController (如 代码 清单 3-6 所 示 )， 让 它 从 注入 的 AmazonProperties 中 获取 
Amazon Associate ID, 











代码 清单 3-6 EA f AmazonPropertieslReadingListController 


package readinglist; 


import 


import 
import 
import 
import 
import 


java.util.List; 


org. 
org. 
org. 
org. 
org. 


springframework. 
springframework. 
springframework. 
springframework. 
springframework. 


GController 


beans.factory.annotation.Autowired; 
Stereotype.Controller; 

ui.Model; 
web.bind.annotation.RequestMapping; 
web.bind.annotation.RequestMethod; 


32 ”通过 属性 文件 外 置 配置 59 





GRequestMapping("/") 
public class ReadingListController ( 


private ReadingListRepository readingListRepository; 
private AmazonProperties amazonProperties; 


GAutowired 
public ReadingListController( M 
ReadingListRepository readingListRepository, XA 4 
: P AmazonProperties 
AmazonProperties amazonProperties) { XE———— 
this.readingListRepository - readingListRepository; 
this.amazonProperties - amazonProperties; 


) 





GRequestMapping (method-RequestMethod.GET) 
public String readersBooks (Reader reader, Model model) ( 
List«Book» readingList - 
readingListRepository.findByReader (reader); 
if (readingList !- null) ( 
model.addAttribute("books", readingList); 
model.addAttribute("reader", reader); 
model.addAttribute("amazonID", amazonProperties.getAssociateId());  «— 








向 模型 中 添加 


Associate ID 


} 
return "readingList"; 


) 





GRequestMapping (method-RequestMethod.POST) 

public String addToReadingList(Reader reader, Book book) ( 
book.setReader(reader); 
readingListRepository.save (book); 
return "redirect:/"; 


) 


ReadingListController 不 再 直接 加 载 配置 属性 ， 转 而 通过 注入 其 中 的 AmazonProper- 
ties Bean 来 获取 所 需 的 信息 。 

如 你 所 见 ， 配置 属性 在 调 优 方面 十 分 有 用 ,这 里 说 的 调 优 不 仅 涵盖 了 自动 配置 的 组 件 , 还 包 
括 注入 自 有 应 用 程序 Bean 的 细节 。 但 如 果 我 们 想 为 不 同 的 部 署 环境 配置 不 同 的 属性 又 该 怎么 办 ? 
让 我 们 看 看 如 何 使 用 Spring 的 Profile 来 设置 特定 环境 的 配置 。 


3.2.3 ”使 用 Profile 进行 配置 


当 应 用 程序 需要 部 署 到 不 同 的 运行 环境 时 , 一 些 配置 细节 通常 会 有 所 不 同 。 比 如 ,数据 库 连 
接 的 细节 在 开发 环境 下 和 测试 环境 下 就 会 不 一 样 ， 在 生产 环境 下 又 不 一 样 。Spring Framework 从 
Spring 3.1 开 始 支持 基于 Profile 的 配置 。Profile 是 一 种 条 件 化 配置 ， 基 于 运行 时 激活 的 Profile， 会 
使 用 或 者 忽略 不 同 的 Bean 或 配置 类 。 

举例 来 说 ， 假 设 我 们 在 代码 清单 3-1 里 创建 的 安全 配置 是 针对 生产 环境 的 ， 而 自动 配置 的 安 
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全 配置 用 在 开发 环境 刚刚 好 。 在 这 个 例子 中 , 我 们 就 能 为 securityconfig 加 上 epProfile 注 解 : 


GProfile("production") 

GConfiguration 

GEnableWebSecurity 

public class SecurityConfig extends WebSecurityConfigurerAdapter { 








j 

这 里 用 的 @Profile 注 解 要 求 运 行 时 激活 production Profile， 这 样 才能 应 用 该 配置 。 如 及 
production Profile 没 有 激活 ， 就 会 忽略 该 配置 ， 而 此 时 缺少 其 他 用 于 覆盖 的 安全 配置 ， 于 是 应 
用 自动 配置 的 安全 配置 。 

设置 spring .profiles.active 属 性 就 能 激活 Profile， 任 意 设置 配置 属性 的 方式 都 能 用 于 
设置 这 个 值 。 例 如 ， 在 命令 行 里 运行 应 用 程序 时 ， 可 以 这 样 激 活 product ion Profile: 


AE 









































$ java -jar readinglist-0.0.1-SNAPSHOT.jar -- 
spring.profiles.active-production 


也 可 以 向 application.yml 里 添加 spring .profiles.active 属 性 : 


spring: 
profiles: 
active: production 


还 可 以 设置 环境 变量 ， 将 其 放 人 application.properties ， 或 者 使 用 3.2 节 开头 提 到 的 各 种 方法 。 

但 由 于 Spring Boot 的 自动 配置 奉 你 做 了 太 多 的 事情 ， 要 找到 一 个 能 放置 erofile 的 地 方 还 
真 不 怎么 方便 。 幸 运 的 是 ，Spring Boot 支 持 为 application.properties 和 application.yml 里 的 属性 配置 
Profile。 

为 了 演示 区 分 Profile 的 属性 ， 假 设 你 希望 针对 生产 环境 和 开发 环境 能 有 不 同 的 日 志 配 置 。 在 
生产 环境 中 ， 你 上 只 关心 WARN 或 更 高 级 别 的 日 志 项 ， 想 把 日 志 写 到 日 志文 件 里 。 在 开发 环境 中 ， 
你 只 想 把 日 志 输 出 到 控制 台 ， 记 录 DEBUG 或 更 高 级 别 。 

而 你 所 要 做 的 就 是 为 每 个 环境 分 别 创 建 配 置 。 那 要 怎么 做 呢 ?” 这 取决 于 你 用 的 是 属性 文件 配 
置 还 是 YAML 配 置 。 

1. 使 用 特定 于 Profile 的 属性 文件 

如 果 你 正在 使 用 application.properties ， 可 以 创建 额外 的 属性 文件 ， 遵 循 application- {profile}. 
properties 这 种 命名 格式 ， 这 样 就 能 提供 特定 于 Profile 的 属性 了 。 

在 日 志 这 个 例子 里 ， 开 发 环境 的 配置 可 以 放 在 名 为 application-development.properties 的 文件 
里 ， 配 置 包 含 日 志 级 别 和 输出 到 控制 台 : 


logging.level.root-DEBUG 
对 于 生产 环境 ，application-production.properties 会 将 日 志 级 别 设置 为 WARN 或 更 高 级 别 ， 并 将 
志 写 入 日 志文 件 : 
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logging.path-/var/logs/ 


logging. 


file-BookWorm.log 


logging.level.root-WARN 


与 此 同时 








， 那 些 并 不 特定 于 哪个 Profile 或 者 保持 默认 值 (以 防 万 一 有 哪个 特定 于 Profile 的 配 





置 不 指定 这 个 值 ) 的 属性 ， 可 以 继续 放 在 application.properties 里 : 


amazon.associatelId-habuma-20 
logging.level.root-INFO 




















2. 使 用 多 Profile YAML 文 件 进行 配置 
如 果 使 用 YAML 来 配置 属性 ， 则 可 以 遵循 与 配置 文件 相同 的 命名 规范 ， 即 创建 application- 











{profile}.yml 这 样 的 YAML 文 件 ， 并 将 与 Profile 无 关 的 属性 继续 放 在 application.yml 里 。 
但 既然 用 了 YAML ， 你 就 可 以 把 所 有 Profile 的 配置 属性 都 放 在 一 个 application.yml 文 件 里 。 举 5 
例 来 说 ， 我 们 可 以 像 下 面 这 样 声 明日 志 配置 : 


logging: 
level: 








root: INFO 


spring: 


profiles: development 


logging: 
level: 


root: DEBUG 


spring: 


profiles: production 


logging: 


path: /tmp/ 
file: BookWorm.log 


level: 


root: WARN 


如 你 所 见 


， 这 个 application.yml 文 件 分 为 三 个 部 分 , 使 用 一 组 三 个 连 字符 C --- ) 作为 分 隔 符 。 





第 二 段 和 第 三 段 分 别 为 spring.profiles 指 定 了 一 个 值 ， 这 个 值 表示 该 部 分 配置 应 该 应 用 在 哪 





^ Profile Œ 。 


第 二 段 中 定义 的 属性 应 用 于 开发 环境 ， 因 为 spring.profiles 设 置 为 








development, 与 之 类 似 ， 最 后 一 段 的 spring .profile 设 置 为 production， 在 broduction 











Profile 被 激活 时 生效 。 
另 一 方面 ， 第 一 段 并 未 指定 spring.profiles， 因 此 这 里 的 属性 对 全 部 Profile 都 生效 ， 或 














者 对 那些 未 设置 该 属性 的 激活 Profile 生 效 。 














除了 自动 配置 和 外 置 配置 属性 ，Spring Boot 还 有 其 他 简化 常用 开发 任务 的 绝招 : 它 自动 配置 
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了 一 个 错误 页 面 , 在 应 用 程序 遇 到 错误 时 显示 。3.3 节 ， 我 们 会 介绍 Spring Boot 的 错误 页 ， 以 及 如 
何 定制 这 个 错误 页 来 适应 我 们 的 应 用 程序 。 


3.3 ”定制 应 用 程序 错误 页 面 


错误 总 是 会 发 生 的 , 那些 在 生产 环境 里 最 健壮 的 应 用 程序 偶尔 也 会 遇 到 麻烦 。 虽然 减 小 用 户 
遇 到 错误 的 概率 很 重要 ， 但 让 应 用 程序 展现 一 个 好 的 错误 页 面 也 同样 重要 。 

近年 来 , 富有 创意 的 错误 页 已 经 成 为 了 一 种 艺术 。 如 果 你 曾 见 到 过 GitHub.com 的 星球 大 战 错 
误 页 ， 或 者 是 DropBox.com 的 Escher 立 方 体 错误 页 的 话 ， 你 就 能 明白 我 在 说 什么 了 。 

我 不 知道 你 在 使 用 阅读 列表 应 用 程序 时 有 没有 碰 到 错误 ,如果 有 的 话 , 你 看 到 的 页 面 应 该 和 
图 3-1 里 的 很 像 。 

Spring Boot 默 认 提 供 这 个 “ 白 标 ”( whitelabel ) 错误 页 ， 这 是 自动 配置 的 一 部 分 。 虽 然 这 比 
Stacktrace 页 面 要 好 一 点 , 但 和 网 上 那些 伟大 的 错误 页 艺术 品 却 不 可 同日 而 语 。 为 了 让 你 的 应 用 程 
序 故障 页 变 成 大 师 级 作品 ， 你 需要 为 应 用 程序 创建 一 个 自 定义 的 错误 页 。 

Spring Boot 自 动 配置 的 默认 错误 处 理 器 会 查找 名 为 error 的 视图 ， 如 果 找 不 到 就 用 默认 的 白 标 
错误 视图 ， 如 图 3-1 所 示 。 因 此 ， 最 简单 的 方法 就 是 创建 一 个 自 定 义 视图 ， 让 解析 出 的 视图 名 为 


erroro 








































































































us e. < D -— nnt © eh e E 
Whitelabel Error Page 


This application has no explicit mapping for /error, so you are seeing this as a fallback. 








Wed Dec 31 16:56:50 CST 2014 
There was an unexpected error (type=Not Found, status-404). 
No message available 








图 3-1 Spring Boot 的 默认 白 标 错误 页 面 
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这 一 点 归根 到 底 取 决 于 错误 视图 解析 时 的 视图 解析 器 。 
口 实现 了 Spring 的 View 接 口 的 Bean， 其 ID 为 error (由 Spring 的 BeanNameViewResolver 
所 解析 )。 
口 如 果 配 置 了 Thymeleaf， 则 有 名 为 errorhtml 的 Thymeleaf 异 板 。 
口 如 果 配 置 了 FreeMarker， 则 有 名 为 error.ftl 的 FreeMarker 模 板 。 
口 如 果 配 置 了 Velocity， 则 有 名 为 errorvm 的 Velocity 模板 。 
口 如 果 是 用 JSP 视 图 ， 则 有 名 为 errorjsp 的 JSP 模 板 。 

为 我 们 的 阅读 列表 应 用 程序 使 用 了 Thymeleaf， 所 以 我 们 要 做 的 就 是 创建 一 个 名 为 
errorhtml 的 文件 ， 把 它 和 其 他 的 应 用 程序 模板 一 起 放 在 模板 文件 夹 里 。 代 码 清单 3-7 是 一 个 简单 
有 效 的 错误 页 ， 可 以 用 来 代替 默认 的 白 标 错误 页 。 


代码 清单 3-7 阅读 列表 应 用 程序 的 自 定义 错误 页 
«html» 
<head> 
«title»Oops!«/title» 
«link rel="stylesheet" th:href-"G(/style.css)"»«/link» 
«/head» 


















































«html» 
«div class-"errorPage"» 
«span class-"oops"»Oops!«/span»«br/» 
«img th:src-"G(/MissingPage.png)"»«/img» 显示 请 
<D>There seems to be a problem with the page you requested 求 路 径 


(«span th:text-"$(path)"»«/span»).«/p» 


«p th:text-"S('Details: ' + message)"'»«/p» 了 一 一 显示 错误 
ME. / 狼 TH 
</div> 明细 
</html> ý 
</html> 


这 个 自 定义 的 错误 模板 应 该 命名 为 errorhtml， 放 在 模板 目录 里 ， 这 样 Thymeleaf 模 板 解 析 器 
才能 找到 它 。 在 典型 的 Maven 或 Gradle 项 目 里 ， 这 就 意味 着 要 把 该 文件 放 在 src/main/resources/ 
templates 中 ， 运 行 时 它 就 在 Classpath 的 根 目 录 里 。 

基本 上 ， 这 个 简单 的 Thymeleaf 模 板 就 是 显示 一 张 图 片 和 一 些 提 示 错 误 的 文字 。 其 中 有 两 处 
特别 的 信息 需要 呈现 : 错误 的 请 求 路 径 和 异常 消息 。 但 这 还 不 是 错误 页 上 的 全 部 细节 。 默 认 情 况 
下 ，Spring Boot 会 为 错误 视图 提供 如 下 错误 属性 。 

O timestamp: 错误 发 生 的 时 间 。 

O status: HTTP 状 态 码 。 

口 error: 错误 原因 。 

O exception: 异常 的 类 名 。 

O message: 异常 消息 ( 如果 这 个 错误 是 由 异常 引起 的 )。 

O errors: BindingResult 异 常 里 的 各 种 错误 ( 如 果 这 个 错误 是 由 异常 引起 的 )。 





























ni 
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O trace: 异常 跟踪 信息 ( 如 果 这 个 错误 是 由 异常 引起 的 )。 
O path: 错误 发 生 时 请 求 的 URL 路 径 。 

其 中 某 些 属性 ， 比 如 path, 在 向 用 户 交 等 问题 时 还 是 很 有 用 的 。 其 他 的 ， 比 如 trace， 用 起 
来 要 保守 一 点 ， 将 其 隐藏 ， 或 者 用 得 聪明 点 ， 让 错误 页 尽 可 能 对 用 户 友好 。 

请 注意 ,模板 里 还 引用 了 一 张 名 为 MissingPage.png 的 图 片 。 图 片 的 实际 内 容 并 不 重要 ， 所 以 
尽情 挑选 适合 你 的 图 片 就 好 了 ， 但 请 一 定 将 它 放 在 src/main/resources/static 或 src/main/resources/ 
public 里 ， 这 样 应 用 程序 运行 时 才能 找到 它 。 

图 3-2 是 发 生 错 误 时 用 户 会 看 到 的 页 面 。 虽然 它 算 不 上 一 件 艺 术 品 ， 但 还 是 把 应 用 程序 错误 
页 的 艺术 水 准 稍 微 提 高 了 那么 一 点 。 





























图 3-2” 遇 到 错误 时 展现 的 自 定义 错误 页 


3.4 ”小结 


Spring Boot 消 除了 Spring 应 用 程序 中 经 常 要 用 到 的 很 多 样板 式 配置 。 让 Spring Boot 处 理 全 部 
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配置 ， 你 可 以 仰 会 它 来 配置 那些 适合 你 的 应 用 程序 的 组 件 。 当 自动 配置 无 法 满足 需求 时 ，Spring 
Boot 人 允许 你 覆盖 并 微调 它 提供 的 配置 。 

覆盖 自动 配置 其 实 很 简单 ， 就 是 显 式 地 编写 那些 没有 Spring Boot 时 你 要 做 的 Spring 配置 。 
Spring Boot 的 自动 配置 被 设计 为 优先 使 用 应 用 程序 提供 的 配置 ， 然 后 才 轮 到 自己 的 自动 配置 。 

即使 自动 配置 合适 ， 你 仍然 需要 调整 一 些 细 节 。Spring Boot 会 开启 多 个 属性 解析 器 ， 让 你 通 
过 环境 变量 、 属 性 文件 、YAML 文 件 等 多 种 方式 来 设置 属性 ， 以 此 微调 配置 。 这 套 基 于 属性 的 配 
置 模型 也 能 用 于 应 用 程序 自己 定义 的 组 件 ， 可 以 从 外 部 配置 源 加 载 属性 并 注入 到 Bean 里 。 

Spring Boot 还 自动 配置 了 一 个 简单 的 白 标 错误 页 ， 虽 然 它 比 异 常 跟踪 信息 友好 一 点 ,但 在 艺 
术 性 方面 还 有 很 大 的 提升 空间 。 幸 运 的 是 ，Spring Boot 提 供 了 好 几 种 选项 来 自 定 义 或 完全 替换 这 
个 白 标 错误 页 ， 以 满足 应 用 程序 的 特定 风格 。 

现在 我 们 已 经 用 Spring Boot 写 了 一 个 完整 的 应 用 程序 ,我 们 会 验证 它 能 否 满足 预期 。 除 了 自 
己 在 浏览 器 里 手工 点 点 之 外 , 我 们 还 应 该 要 写 一 些 自动 化 、 可 重复 运行 的 测试 来 检查 这 个 应 用 程 
序 ， 证 明 它 能 正确 运作 。 这 也 是 我 们 在 第 4 章 里 要 做 的 事 。 
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本 章 内 容 

口 集成 测试 

口 在 服务 器 里 测试 应 用 程序 
O Spring Boot 的 测试 辅助 工具 











有 人 说 ， 如 果 你 不 知道 要 去 哪 ， 走 就 是 了 。 但 在 软件 开发 领域 ,如 果 你 没有 日 标 ， 那 结果 往 
往 是 开发 出 一 个 满 是 bug 的 应 用 程序 ， 没 人 用 得 了 。 

在 编写 应 用 程序 时 ， 明 确 目标 的 最 佳 方法 就 是 写 测 试 ， 确 定 应 用 程序 的 行为 是 否 符合 预期 。 
如 果 测 试 失败 了 ,你 就 有 活 要 干 了 。 如 果 测 斌 通过 了 ， 那 你 就 成 功 了 ( 至 少 在 你 觉得 还 有 其 他 测 
试 要 写 之 前 ， 是 这 样 的 )。 

究竟 是 在 编写 业务 代码 之 前 还 是 之 后 写 测 试 , 这 并 不 重要 。 重 要 的 是 ， 写 测试 不 仅仅 是 为 了 
验证 代码 的 准确 性 , 还 要 确认 它 符 合 预 期 。 测试 也 是 一 道 保障 , 确认 应 用 程序 在 改进 的 同时 不 会 
破坏 已 有 的 东西 。 

在 编写 单元 测试 的 时 候 ，Spring 通 常 不 需要 介入 。Spring 鼓 励 松 耦合 、 接 口 驱动 的 设计 ， 这 
些 都 能 让 你 很 轻松 地 编写 单元 测试 。 但 是 在 写 单 元 测试 时 并 不 需要 用 到 Spring。 

但 是 ， 集 成 测试 要 用 到 Spring。 如 果 生 产 应 用 程序 使 用 Spring 来 配置 并 组 装 组件 ， 那 么 测试 
就 需要 用 它 来 配置 并 组 装 那些 组 件 。 

Spring 的 springJunit4ClassRunner 可 以 在 基于 JUnit 的 应 用 程序 测试 里 加 载 Spring 应 用 程 
序 上 下 文 。 在 测试 Spring Boot 应 用 程序 时 ，Spring Boot 除 了 拥有 Spring 的 集成 测试 支持 ， 还 开启 
了 自动 配置 和 Web 服 务 器 ， 并 提供 了 不 少 实用 的 测试 辅助 工具 。 

在 本 章 中 ， 我 们 会 看 到 Spring Boot 的 各 种 集成 测试 支持 。 让 我 们 先 来 看 看 如 何在 Spring Boot 
应 用 程序 上 下 文 里 做 测试 。 


4.1 集成 测试 自动 配置 


Spring Framework 的 核心 工作 是 将 所 有 组 件 编织 在 一 起 ， 构 成 一 个 应 用 程序 。 整 个 过 程 就 是 
读 取 配置 说 明 ( 可 以 是 XML、 基 于 Java 的 配置 、 基 于 Groovy 的 配置 或 其 他 类 型 的 配置 )， 在 应 用 
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程序 上 下 文 里 初始 化 Bean， 将 Bean 注 入 依赖 它们 的 其 他 Bean 中 。 

对 Spring 应 用 程序 进行 集成 测试 时 ， 让 Spring 遵照 生产 环境 来 组 装 测 试 目 标 Bean 是 非常 重要 
的 一 点 。 当然 , 你 也 可 以 手动 初始 化 组 件 , 并 将 它们 注入 其 他 组 件 , 但 对 那些 大 型 应 用 程序 来 说 ， 
这 是 项 费时 费力 的 工作 。 而 且 ，Spring 提 供 了 额外 的 辅助 功能 ， 比 如 组 件 扫描 、 自 动 织 入 和 声明 
性 切面 (缓存 、 事 务 和 安全 ， 等 等 )。 你 要 把 这 些 活 都 于 了 ， 基 本 也 就 是 把 Spring 再 造 了 一 次 ,最 
好 还 是 让 Spring 蔡 你 把 重活 都 做 了 吧 ， 哪 怕 是 在 集成 测试 里 。 

Spring 自 1.1.1 版 就 向 集成 测试 提供 了 极 佳 的 支持 。 自 Spring 2.5 开 始 ， 集 成 测试 支持 的 形式 就 
变 成 了 springJUnit4ClassRunner。 这 是 一 个 JUnit 类 运行 器 , 会 为 JUnit 测 试 加 载 Spring 应 用 程 
序 上 下 文 ， 并 为 测试 类 自动 织 入 所 需 的 Bean。 

举例 来 说 ， 看 一 下 代码 清单 4-1， 这 是 一 个 非常 基本 的 Spring 集成 测试 。 


代码 清单 4-1 用 springJuUnit4ClassRunner 对 Spring 应 用 程序 进行 集成 测试 


@RunWith (SpringJUnit4ClassRunner.class) . 过 
GContextConfiguration( 加 载 应 用 程序 上 


classes-AddressBookConfiguration.class) < 下文 
public class AddressServiceTests { 

















































































































QGAutowired 注入 地 址 服务 
private AddressService addressService; < 一 
GTest 
public void testService() ( I 
Address address = addressService.findByLastName("Sheman"); 测试 地 址 服务 


assertEquals("P", address.getFirstName()); 
assertEquals("Sherman", address.getLastName()); 
assertEquals("42 Wallaby Way", address.getAddressLine1()); 
assertEquals("Sydney", address.getCity()); 
assertEquals("New South Wales", address.getState()); 
assertEquals("2000", address.getPostCode()); 


} 


如 你 所 见 , AddressServiceTests 上 加 注 了 @RunWith 和 @ContextConfiguration 注 解 。 
@RunWith 的 参数 是 springJUnit4ClassRunner.class， 开 启 了 Spring 集 成 测试 支持 。" 与 此 
同时 ,econtextconfiguration 指 定 了 如 何 加 载 应 用 程序 上 下 文 。 此 处 我 们 让 它 加 载 Aaaress- 
Bookconfiguration 里 配置 的 Spring 应 用 程序 上 下 文 。 

除了 加 载 应 用 程序 上 下 文 ， SpringJUunit4classRunner 还 能 通过 自 动 织 人 从 应 用 程序 上 下 
文 里 向 测试 本 身 注 入 Bean。 因 为 这 是 一 个 针对 Adaaressservice Bean 的 测试 ， 所 以 需要 将 它 注 
和 测试。 最 后 ，testservice() 方 法 调用 地 址 服务 并 验证 了 结果 。 


























在 Spring 4.2 里 ， 你 可 以 选择 基于 规则 的 springclassRule 和 SpringMethodRule 来 代替 SpringJUnit4Class- 


Runners 
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虽然 econtextconfiguration 在 加 载 Spring 应 用 程序 上 下 文 的 过 程 中 做 了 很 多 事情 ， 但 它 

能 加 载 完整 的 Spring Boot. Spring Boot 应 用 程序 最 终 是 由 SpringaApplication 加 载 的 。 它 可 
( 如 代码 清单 2-1 所 示 )， 在 这 里 也 可 以 使 用 springBootSservletInitializer (我 
们 会 在 第 8 章 里 看 到 具体 做 法 ), springApplication 不 仅 加 载 应 用 程序 上 下 文 , 还 会 开启 日 志 、 
加 载 外 部 属性 ( application.properties 或 application.yml ), 以 及 其 他 Spring Boot 特 性 。 Hjecontext- 
Configuration 则 得 不 到 这 些 特性 。 

要 在 集成 测试 里 获得 这 些 特性 ， 可 以 把 @QContextconfiguration 替 换 为 Spring Boot 的 


@SpringApplicationConfiguration: 






































GRunWith(SpringJUnit4ClassRunner.class) 
GSpringApplicationConfiguration( 
Cclasses-AddressBookConfiguration.class) 

public class AddressServiceTests ( 

i F 

esSpringaApplicationconfiguration 的 用 法 和 econtextconfiguration 大 致 相同 ， 但 
也 有 不 同 的 地 方 ，espringaApplicationconfiguration 加 载 Spring 应 用 程序 上 下 文 的 方式 同 
springApplication 相 同 ， 处 理 方式 和 生产 应 用 程序 中 的 情况 相同 。 这 包括 加 载 外 部 属性 和 
Spring Boot 日 志 。 

我 们 有 充分 的 理由 说 , 在 大 多 数 情况 下 , 为 Spring Boot 应 用 程序 编写 测试 时 应 该 用 espring- 
Applicationconfiguration 代 替 econtextCconfiguration。 在 本 章 中 ， 我 们 当然 也 会 用 
espringaApplicationconfiguration 来 为 Spring Boot 应 用 程序 ( 包括 那些 面向 前 端的 应 用 程 
序 ) 编写 测试 。 

说 到 Web 测 试 ， 这 正 是 我 们 接 下 来 要 做 的 。 


4.2 测试 Web 应 用 程序 


Spring MVC 有 一 个 优点 : 它 的 编程 模型 是 围绕 POJO 展 开 的 ， 在 POJO 上 添加 注解 , 声明 如 何 
处 理 Web 请 求 。 这 种 编程 模型 不 仅 简 单 ， 还 让 你 能 像 对 待 应 用 程序 中 的 其 他 组 件 一 样 对 待 这 些 控 
制 器 。 你 还 可 以 针对 这 些 控制 器 编写 测试 ， 就 像 测试 POJO 一 样 。 

举例 来 说 ， 考 虑 ReadingListcontroller 里 的 addToReadingList () 方 法 : 










































































GRequestMapping (method-RequestMethod.POST) 
public String addToReadingList(Book book) ( 
book.setReader(reader); 
readingListRepository.save (book); 
return "redirect:/readingList"; 


) 

如 果 和 忽略 eRequestMapping 注 解 ， 你 得 到 的 就 是 一 个 相当 基础 的 Java 方 法 。 你 立马 就 能 想 
到 这 Ue iX, 提供 一 个 ReadingListRepository 的 模拟 实现 ， 直接 调用 addToReading- 
List(), 判断 返回 值 并 验证 对 ReadingListRepository 的 save () 方 法 有 过 调用 。 

















4.20 测试 Web 应 用 程序 69 





该 测试 的 问题 在 于 ， 它 仅仅 测试 了 方法 本 身 ， 当 然 , 这 要 比 没有 测试 好 一 点 。 RM, CRA 
测试 该 方法 处 理 /readingList 的 PosT 请 求 的 情况 ， 也 没有 测试 表单 域 绑 定 到 Book 人 参数 的 情况 。 虽 
然 你 可 以 判断 返回 的 string 包 含 特 定 值 ， 但 没 法 明确 测试 请 求 在 方法 处 理 完 之 后 是 否 真 的 会 重 
定向 到 /readingList。 

要 恰当 地 测试 一 个 Web 应 用 程序 ， 你 需要 投入 一 些 实际 的 HTTP 请 求 ， 确 认 它 能 正确 地 处 理 
那些 请 求 。 幸 运 的 是 ，Spring Boot 开 发 者 有 两 个 可 选 的 方案 能 实现 这 类 测试 。 
Q Spring Mock MVC: 能 在 一 个 近似 真实 的 模拟 Servlet 容 器 里 测试 控制 器 ， 而 不 用 实际 启动 
应 用 服务 器 。 
口 Web 集 成 测试 : 在 能 入 式 Servlet 容 器 (比如 Tomcat 或 Jetty ) 里 启动 应 用 程序 ， 在 真正 的 应 

用 服务 器 里 执行 测试 。 

这 两 种 方法 各 有 利弊 。 很 明显 ， 启 动 一 个 应 用 服务 器 会 比 模拟 Servlet 容 需要 慢 一 些 ， 但 毫 无 
疑问 基于 服务 器 的 测试 会 更 接近 真实 环境 ， 更 接近 部 署 到 生产 环境 运行 的 情况 。 

接 下 来 ， 你 会 看 到 如 何 使 用 Spring Mock MVC 测 试 框架 来 测试 Web 应 用 程序 。 然 后 ， 在 4.3 节 
里 你 会 看 到 如 何 为 运行 在 应 用 服务 器 里 的 应 用 程序 编写 测试 。 












































4.2.1 模拟 Spring MVC 


早 在 Spring 3.2, Spring Framework 就 有 了 一 套 非常 实用 的 Web 应 用 程序 测试 工具 ， 能 模拟 
Spring MVC, 不 需要 真实 的 Servlet 容 器 也 能 对 控制 器 发 送 HTTP 请 求 。Spring 的 Mock MVC 框 架 模 
TU T Spring MVC 的 很 多 功能 。 它 几乎 和 运行 在 Servlet 容 需 里 的 应 用 程序 一 样 , 尽管 实际 情况 并 非 
如 此 。 

要 在 测试 里 设置 Mock MVC， 可 以 使 用 MockMvcBuilders， 该 类 提供 了 两 个 静态 方法 。 

O standalonesetup () : 构建 一 个 Mock MVC, 提供 一 个 或 多 个 手工 创建 并 配置 的 控制 器 。 
D webAppContextSetup(): 使 用 Spring 应 用 程序 上 下 文 来 构建 Mock MVC， 该 上 下 文 里 
可 以 包含 一 个 或 多 个 配置 好 的 控制 器 。 

两 者 的 主要 区 别 在 于 ，stangqaloneSetup () 和 希望 你 手工 初始 化 并 注入 你 要 测试 的 控制 器 ， 
而 webAppContextSetup() 则 基于 一 个 WebApplicationContext 的 实例 ， 通 常 由 Spring 加 载 E 
前 者 同 单元 测试 更 加 接近 ， 你 可 能 只 想 让 它 专 注 于 单一 控制 器 的 测试 ， 而 后 者 让 Spring 加 载 控制 
器 及 其 依赖 ， 以 便 进 行 完整 的 集成 测试 。 

我 们 要 用 的 是 wepAppContextSetup()。Spring 完 成 了 ReadingListcontroller 的 初始 
化 ， 并 从 Spring Boot 自 动 配置 的 应 用 程序 上 下 文 里 将 其 注入 ， 我 们 直接 对 其 进行 测试 。 

webAppContextSetup () 接 受 一 个 WepApplicationContext 参 数 。 此 ， 我 们 需要 为 测 
试 类 加 上 ewebaAppconfiguration 注 解 ， 使 用 @Autowi red 将 WebApplicationContext 作 为 实 
例 变量 注入 测试 类 。 代 码 清 单 4-2 演 示 了 Mock MVC 测 试 的 执行 人 口 。 


代码 清单 4-2 ”为 集成 测试 控制 器 创建 Mock MVC 


@RunWith (SpringJUnit4ClassRunner.class) 
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GSpringApplicationConfiguration( 


classes - ReadingListApplication.class) 


GWebAppConfiguration 
public class MockMvcWebTests ( 


GAutowired 


private WebApplicationContext webContext; 


private MockMvc mockMvo; 


GBefore 
public void setupMockMvc() { 
mockMvc - MockMvcBuilders 
.webAppContextSetup (webContext) 
.buila(0; 


} 


开启 Web 上 下 文 
测试 





注入 


WebApplicationContext 





二 一 
| 设置 MockMvc 





QWebAppConfigurat ion 注 解 声 明 , H springJUnit4ClassRunner 创 建 的 应 用 程序 上 下 
文 应 该 是 一 个 NebApplicationContext (相对 于 基本 的 非 WebApplicationContext )。 


setupMockMvc ( 


个 MockMvc 实 例 ， 该 实例 赋 给 了 一 个 实例 变量 ， 


现在 我 们 有 了 一 个 MockMvc, 已 经 可 以 开 
/readingList 发 送 一 个 HTTP GET 请 求 ， 判断 模型 和 视图 是 否 满 足 我 们 的 期 望 。 








测试 方法 就 是 我 们 所 需要 的 : 


@Test 
public void homePage() 


) 方 法 上 添加 了 JUnit 的 eBefore 注 解 , 表明 它 应 该 在 测试 方法 之 前 执行 。 它 


将 WepapplicationContext 注 人 webAppContextSetup() 方 法 ， 


然后 调用 build() 产 生 了 一 





供 测 试 方法 使 用 。 


台 写 测试 方法 了 。 我们 先 写 个 简单 的 测试 方法 ,向 





下 面 的 homePage () 


throws Exception { 


mockMvc.perform(MockMvcRequestBuilders.get("/readingList")) 


.andExpect (MockMvcResultMatchers.status() 
.andExpect (MockMvcResultMatchers.view() 
.andExpect (MockMvcResultMatchers.model() 
.andExpect (MockMvcResultMatchers.model() 


.isOk()) 
.name("readingList")) 
.attributeExists("books")) 
.attribute("books", 


Matchers.is(Matchers.empty()))); 


} 


如 你 所 见 ， 我 们 在 这 个 测试 方法 里 使 用 了 很 多 静态 方法 ,包括 Spring 的 MockMvcRequest- 


Buildqers 和 


ockMvcResultMatchers 里 的 静态 方法 , 还 有 Hamcrest 库 的 Matchers 里 的 静态 方 
法 。 在 深入 探讨 这 个 测试 方法 前 ， 先 添加 一 些 静 态 import ， 


import static org.hamcrest.Matchers.*; 








这 样 代码 看 起 来 更 清爽 一 些 : 


JA 


import static org.springframework.test.web.servlet.request. 


MockMvcRequestBuilders.*; 


import static org.springframework.test.web.servlet.result. 


MockMvcResultMatchers.*; 


有 了 这 些 静 态 import 后 ， 











测试 方法 可 以 稍 作 调 整 : 
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GTest 
public void homePage() throws Exception ( 
mockMvc.perform(get("/readingList")) 
.andExpect (status().isOk()) 
.andExpect (view().name("readingList")) 
.andExpect (model().attributeExists("books")) 
.andExpect (model().attribute("books", is(empty()))); 
} 


现在 这 个 测试 方法 读 起 来 就 很 自然 了 。 首 先 向 /readingList 发 起 一 个 cET 请 求 ， 接 下 来 希望 该 
请 求 处 理 成 功 ( isok () 会 判断 HTTP 200 响 应 码 )， 并 且 视 图 的 钦 辑 名 称 为 readingList。 测 试 
还 要 断定 模型 包含 一 个 名 为 books 的 属性 ， 该 属性 是 一 个 空 集合 。 所 有 的 断言 都 很 直观 。 

值得 一 提 的 是 ， 此 处 完全 不 需要 将 应 用 程序 部 署 到 Web 服 务 咒 上 ， 它 是 运行 在 模拟 的 Spring 
MVC 中 的 ， 刚 好 能 通过 MockMvc 实 例 处 理 我 们 给 它 的 HTTP 请 求 。 

太 酷 了 ， 不 是 吗 ? 

让 我 们 再 来 看 一 个 测试 方法 , 这 次 会 更 有 趣 , 我 们 实际 发 送 一 个 HTTP POST 请 求 提交 一 本 新 
书 。 我 们 应 该 期 待 PosT 请 求 处 理 后 重 定 向 回 /readingList, 模型 将 包含 新 添加 的 图 书 。 代码 清单 4-3 
演示 了 如 何 通 过 Spring 的 Mock MVC 来 实现 这 个 测试 。 


代码 清单 4-3 ”测试 提交 一 本 新 书 
























































@Test 
public void postBook() throws Exception { 执行 POST 请 求 
mockMvc.perform(post("/readingList") < 一 一 

.contentType (MediaType.APPLICATION FORM URLENCODED) 

.param("title", "BOOK TITLE") 

.param("author", "BOOK AUTHOR") 

.param("isbn", "1234567890") 

.param("description", "DESCRIPTION")) 

.andExpect (status().is3xxRedirection()) 

.andExpect (header().string("Location", "/readingList")); 
Book expectedBook - new Book(); < 
expectedBook.setId(1L); 配置 期 望 的 图 书 





expectedBook.setReader("craig"); 
expectedBook.setTitle("BOOK TITLE"); 
expectedBook.setAuthor("BOOK AUTHOR"); 
expectedBook.setIsbn("1234567890"); 
expectedBook.setDescription("DESCRIPTION"); 





mockMvc.perform(get("/readingList")) < 一 
.andExpect (status () .isOk()) 执行 GET 请 求 
.andExpect (view().name("readingList")) 
.andExpect (model().attributeExists("books")) 
.andExpect (model().attribute("books", hasSize(1))) 
.andExpect (model().attribute("books", 
contains (samePropertyValuesAs (expectedBook)))); 


) 
很 明显 ， 代 码 清单 4-3 里 的 测试 更 加 复杂 ， 实 际 上 是 两 个 测试 放 在 一 个 方法 里 。 第 一 部 分 提 
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交 图 书 并 检查 了 请 求 的 结果 ， 第 二 部 分 执行 了 一 次 对 主页 的 GET 请 求 ， 检 查 新 建 的 图 书 是 否 在 模 
型 中 。 

在 提交 图 书 时 , 我 们 必须 确保 内 容 类 型 (通过 MediaType .APPLICATION_FORM_URLENCODED ) 
设置 为 application/x-www-form-urlencoded， 这 才 是 运行 应 用 程序 时 浏览 器 会 发 送 的 内 容 类 型 。 随 
后 ， 要 用 MockMvcRequestBuilders 的 param 方 法 设置 表单 域 ， 模拟 要 提交 的 表单 。 一 旦 请 求 
执行 ,我 们 要 检查 响应 是 否 是 一 个 到 /eadingList 的 重 定向 。 

假定 以 上 测试 都 通过 ， 我 们 进入 第 二 部 分 。 首 先 设 置 一 个 Book 对 象 ， 包 含 想 要 的 值 。 我 们 
用 这 个 对 象 和 首页 获取 的 模型 的 值 进行 对 比 。 

随后 要 对 /readingList 发 起 一 个 GET 请 求 ， 大 部 分 内 容 和 我 们 之 前 测试 主页 时 一 样 ， 只 是 之 前 
模型 中 有 一 个 空 集合 , 而 现在 有 一 个 集合 项 。 这 里 要 检查 它 的 内 容 是 否 和 我 们 创建 的 expected- 
Book 一 致 。 如 此 一 来 ,我 们 的 控制 器 看 来 保存 了 发 送 给 它 的 图 书 ， 完 成 了 工作 。 

至 此 ， 这 些 测试 验证 了 一 个 未 经 保护 的 应 用 程序 ， 和 我 们 在 第 2 章 里 写 的 应 用 程序 很 类 似 。 
但 如 果 我 们 想 要 测试 一 个 安全 加 固 过 的 应 用 程序 C 比如 我 们 在 第 3 章 里 写 的 程序 )， 又 该 怎么 办 ? 






























































4.2.2 ”测试 Web 安全 


Spring Security 能 让 你 非常 方便 地 测试 安全 加 固 后 的 Web 应 用 程序 。 为 了 利用 这 点 优势 , 你 必 
须 在 项 目 里 添加 Spring Security 的 测试 模块 。 要 在 Gradle 里 做 到 这 一 点 ， 你 需要 的 就 是 以 下 
testcomopile 依 赖 : 





testCompile("org.springframework.security:spring-security-test") 
如 果 你 用 的 是 Maven， 则 添加 以 下 <depengdency>: 


<dependency> 
<groupId>org.springframework.security</groupId> 
<artifactId>spring-security-test</artifactId> 
<scope>test</scope> 

</dependency> 


应 用 程序 的 Classpath 里 有 了 Spring Security 的 测试 模块 之 后 , 只 需 在 创建 MockMvc 实 例 时 运用 
Spring Security 的 配置 器 。 








@Before 

public void setupMockMvc() { 

mockMvc - MockMvcBuilders 
.webAppContextSetup (webContext) 
.apply(springSecurity()) 
.build(); 





} 

springSecurity () 方 法 返回 了 一 个 Mock MVC 配 置 器 , 为 Mock MVC 开 启 了 Spring Security 
支持 。 只 需 像 上 面 这 样 运 用 就 行 了 ，Spring Security 会 介入 MockMvc 上 执行 的 每 个 请 求 。 具 体 的 
安全 配置 取决 于 你 如 何 配 置 Spring Security ( 或 者 Spring Boot 如 何 自动 配置 Spring Security )。 在 阅 
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读 列 表 这 个 应 用 程序 里 ， 我 们 在 第 3 章 里 创建 securityconfig.java 时 ， 配 置 也 是 如 此 。 


springSecurity() 方 法 springSecurity()X€SecurityMockMvcConfigurers 
的 一 个 静态 方法 ， 考 虑 到 可 读 性 ， 我 已 经 将 其 静态 导入 。 


开启 了 Spring Security 之 后 ， 在 请 求 主页 的 时 候 ， 我 们 便 不 能 只 期 待 HTTP 200 响 应 。 如 果 请 
求 未 经 身份 验证 ， 我 们 应 该 期 待 重 定 向 到 登录 页 面 : 


@Test 
public void homePage unauthenticatedUser() throws Exception ( 
mockMvc.perform(get("/")) 
.andExpect (status().is3xxRedirection()) 
.andExpect (header().string("Location", 
"http://localhost/login")); 








j 

不 过 ， 经 过 身份 验证 的 请 求 又 该 如 何 发 起 呢 ? Spring Security 提 供 了 两 个 注解 。 

O ewithMockUser: 加 载 安 全 上 下 文 , 其 中 包含 一 个 UserDetails, 使 用 了 给 定 的 用 户 名 、 
密码 和 授权 。 

O ewithUserDetails: 根据 给 定 的 用 户 名 查找 UserDetails 对 象 ， 加 载 安全 上 下 文 。 

在 这 两 种 情况 下 ，Spring Security 的 安全 上 下 文 都 会 加 载 一 个 UserDetails 对 象 ， 添 加 了 该 














注解 的 测试 方法 在 运行 过 程 中 都 会 使 用 该 对 象 ewithMockUser 注 解 是 两 者 里 比较 基础 的 那个 ， 
人 允许 显 式 声明 一 个 UserDetails， 并 加 载 到 安全 上 下 文 。 
GTest 


QWithMockUser (username-"craig", 
password-"password", 
roles-"READER") 
public void homePage authenticatedUser() throws Exception ( 


} 

如 你 所 见 ，ewithMockUser 绕 过 了 对 UserDetails 对 象 的 正常 查询 ， 用 给 定 的 值 创建 了 一 
个 UserDetails 对 象 取而代之 。 在 简单 的 测试 里 ， 这 就 够 用 了 。 但 我 们 的 测试 需要 Reader ( 实 
现 了 UserDetails ) 而 非 ewithMockUser 创 建 的 通用 Userpetails 。 为 此 ， 我 们 需要 
@WithUserDetailso 

ewithUserDetails 注 解 使 用 事先 配置 好 的 Userpetailsservice 来 加 载 UserDetails 对 
象 。 回 想 一 下 第 3 章 , 我 们 配置 了 一 个 UserDetailsService Bean， 它 会 根据 给 定 的 用 户 名 查找 
并 返回 一 个 Reader 对 象 。 太 完美 了 ! 所 以 我 们 要 为 测试 方法 添加 ewithUserDetails 注 解 ， 如 
代码 清单 4-4 所 示 。 


代码 清单 4-4 ”测试 带 有 用 户 吴 份 验证 的 安全 加 固 方 法 


GTest 





























QWithUserDetails("craig") 
public void homePage authenticatedUser() throws Exception { 使 用 craig 用 户 
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Reader expectedReader - new Reader(); < 一 一 一 
expectedReader.setUsername ("craig"); 配置 期 望 的 
expectedReader.setPassword("password"); Reader 





expectedReader.setFullname("Craig Walls"); 


mockMvc.perform(get("/")) | g 
.andExpect (status().isOk()) 发 起 cz 请 
.andExpect (view().name("readingList")) 求 
.andExpect (model().attribute("reader", 


samePropertyValuesAs (expectedReader))) 
.andExpect (model().attribute("books", hasSize(0))) 


j 

在 代码 清单 4-4 里 ， 我 们 通过 ewithUserDetails 注 解 声明 要 在 测试 方法 执行 过 程 中 向 安全 
上 下 文 里 加 载 craig 用 户 。Reaaqaez 会 放 和 人 模型 ， 该 测试 方法 先 创建 了 一 个 期 望 的 Readqer 对 象 ， 后 
续 可 以 用 来 进行 比较 。 随 后 GET 请 求 发 起 ， 也 有 了 针对 视图 名 和 模型 内 容 的 断言 ， 其 中 包括 名 为 
reader 的 模型 属性 。 

同样 ， 此 处 没有 启动 Servlet 容 器 来 运行 这 些 测试 ，Spring 的 Mock MVC 取 代 了 实际 的 Servlet 
容器 。 这 样 做 的 好 处 是 测试 方法 运行 相对 较 快 。 因 为 不 需要 等 待 服务 器 启动 ， 而 且 不 需要 打开 
Web 浏 览 咒 发 送 表 单 ， 所 以 测试 比较 简单 快捷 。 

不 过 ， 这 并 不 是 一 个 完整 的 测试 。 它 比 直 接 调用 控制 器 方法 要 好 ,但 它 并 没有 真 的 在 Web 浏 
览 器 里 执行 应 用 程序 ， 验 证 呈现 出 的 视图 。 为 此 ， 我 们 需要 启动 一 个 真正 的 Web 服 务 器 ， 用 真实 
浏览 器 来 访问 它 。 让 我 们 来 看 看 Spring Boot 如 何 启 动 一 个 真实 的 Web 服 务 器 来 帮助 测试 。 


4.3 测试 运行 中 的 应 用 程序 


说 到 测试 Web 应 用 程序 ， 我们 还 没 接触 实质 内 容 。 在 真实 的 服务 器 里 启动 应 用 程序 ， 用 真实 
的 Web 浏 览 器 访问 它 ， 这 样 比 使 用 模拟 的 测试 引擎 更 能 展现 应 用 程序 在 用 户 端 的 行为 。 

但 是 ,用 真实 的 Web 浏 览 吉 在 真实 的 服务 器 上 运行 测试 会 很 麻烦 。 虽 然 构建 时 的 插件 能 把 应 
用 程序 部 署 到 Tomceat 或 者 Jetty 里 ， 但 它们 配置 起 来 多 有 不 便 。 而 且 测试 这 么 多 ， 几 乎 不 可 能 隔离 
运行 ， 也 很 难 不 启动 构建 工具 。 

然而 Spring Boot 找 到 了 解决 方案 。 它 文 持 将 Tomecat 或 Jetty 这 样 的 能 入 式 Servlet 容 需 作 为 运行 
中 的 应 用 程序 的 一 部 分 ， 可 以 运用 相同 的 机 制 ， 在 测试 过 程 中 用 能 人 式 Servlet 容 器 来 启动 应 用 
程序 。 

Spring Boot 的 ewebIntegrationTest 注 解 就 是 这 人 么 做 的 。 在 测试 类 上 添加 eweb- 
IntegrationTest 注 解 ， 可 以 声明 你 不 仅 希望 Spring Boot 为 测试 创建 应 用 程序 上 下 文 ， 还 要 启 
动 一 个 能 入 式 的 Servlet 容 器 。 一 旦 应 用 程序 运行 在 谍 和 人 式 容 器 里 ， 你 就 可 以 发 起 真实 的 HTTP 请 
求 ， 断 言 结果 了 。 

举例 来 说 ， 考 虑 一 下 代码 清单 4-$ 里 的 那 段 简单 的 Web 测 试 。 这 里 采用 ewebIntegration- 
Test， 在 服务 器 里 启动 了 应 用 程序 ， 以 Spring 的 RestTemplate 对 应 用 程序 发 起 HTTP 请 求 。 
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代码 清单 4-5 测试 运行 在 服务 器 里 的 Web 应 用 程序 
QGRunWith(SpringJUnit4ClassRunner.class) 
QGSpringApplicationConfiguration( " 
classes-ReadingListApplication.class) 在 服务 器 里 运 
@WebIntegrationTest q 行 测试 
public class SimpleWebTest { 


@Test (expected=HttpClientErrorException.class) 
public void pageNotFound() { 


try ( 
RestTemplate rest - new RestTemplate(); í T 
rest.getForObject( 发 起 GET 请 求 
"http://localhost:8080/bogusPage", String.class); 


fail("Should result in HTTP 404"); 

) catch (HttpClientErrorException e) ( 

assertEquals(HttpStatus.NOT FOUND, e.getStatusCode()); < 

DER UR 判断 HTTP 404 


} (not found) 响 应 
} 








} 


虽然 这 个 测试 非常 简单 , 但 足以 演示 如 何 使 用 ewebIntegrationTest 在 服务 器 里 启动 应 用 
程序 。 要 判断 实际 启动 的 服务 器 究竟 是 哪个 , 可 以 遵循 在 命令 行 里 运行 应 用 程序 时 的 逻辑 。 默 认 
情况 下 , 会 有 一 个 监听 8080 端 口 的 Tomcat 启 动 。 但 是 , 如 果 Classpath 里 有 的 话 , Jetty 或 者 Undertow 
也 能 启动 这 些 服务 器 。 

测试 方法 的 主体 部 分 假设 应 用 程序 已 经 运行 ， 监 听 了 8080 端 口 。 它 使 用 了 Spring 的 
RestTemplate 对 一 个 不 存在 的 页 面 发 起 请 求 ， 判 断 服务 器 的 响应 是 否 为 HTTP 404 ( NOT 
FOUND )。 如 果 返 回 了 其 他 响应 ， 则 测试 失败 。 


4.3.1 用 随机 端口 启动 服务 器 


前 面 提 到 过 , 此 处 的 默认 行为 是 启动 服务 器 监听 8080 端 口 。 在 一 台 机 器 上 一 次 只 运行 一 个 测 
试 的话 ， 这 没什么 问题 ， 因 为 没有 其 他 服务 器 监听 8080 端 口 。 但 如 果 你 和 我 一 样 , 本 机 总 是 有 其 
他 服务 器 在 监听 8080 端 口 , 那 该 怎么 办 ? 这 时 测试 会 失败 ， 因 为 端口 冲突 ,服务 央 启动 不 了 。 一 
定 要 有 更 好 的 办 法 才 行 。 

幸运 的 是 ， 让 Spring Boot 在 随机 选择 的 端口 上 局 动 服 务 需 很 方便 。 一 种 办 法 是 将 
server .bort 属 性 设置 为 0， 让 Spring Boot 选 择 一 个 随机 的 可 用 端口 。ewebIntegrationTest 
的 value 属 性 接受 一 个 String 数 组 ， 数 组 中 的 每 项 都 是 键 值 对 , 形 如 name=value， 用 来 设置 测 
试 中 使 用 的 属性 。 要 设置 server .port ， 你 可 以 这 样 做 : 

@WebIntegrationTest (value={"server.port=0"}) 

另外 ， 因 为 只 要 设置 一 个 属性 ， 所 以 还 能 有 更 简单 的 形式 : 


QGWebIntegrationTest("server.port-0") 
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通过 value 属 性 来 设置 属性 通常 还 算 方 便 。 但 ewebIntegrationTest 还 提供 了 一 个 
randomPort 属 性 ， 更 明确 地 表示 让 服务 器 在 随机 端口 上 启动 。 你 可 以 将 randqomPort 设 置 为 
true， 启 用 随机 端口 : 

@WebIntegrationTest (randomPort=true) 

既然 我 们 在 随机 端口 上 启动 了 服务 器 ,就 需要 在 发 起 Web 请 求 时 确保 使 用 正确 的 端口 。 此 时 
的 getForObject () 方 法 在 URL 里 硬 编码 了 8080 端 口 。 如 果 端 口 是 随 机 选择 的 , 那 在 构造 请 求 时 
又 该 怎么 确定 正确 的 端口 呢 ? 

首先 , 我 们 需要 以 实例 变量 的 形式 注入 选中 的 端口 。 为 了 方便 , Spring Boot 将 local .server . 
port 的 值 设 置 为 了 选中 的 端口 。 我 们 只 需 使 用 Spring 的 evalue 注 解 将 其 注入 即 可 : 


E 




















GValue("$(local.server.port)") 
private int port; 


有 了 端口 之 后 ， 只 需 对 getForobject () 稍 作 修改 ， 使 用 这 个 port 就 好 了 : 


rest.getForObject( 
"http://localhost:(port)/bogusPage", String.class, port); 


这 里 我 们 在 UREL 里 把 硬 编码 的 8080 改 为 fport} 占 位 符 。 在 getForobject 0 调用 里 把 port 
属性 作为 最 后 一 个 参数 传人 ， 就 能 确保 该 占 位 符 被 奉 换 为 注入 port 的 值 了 。 


















































4.3.2 ”使 用 Selenium 测试 HTML. 页 面 


RestTemplate 对 于 简单 的 请 求 而 言 使 用 方便 ， 是 测试 REST 端 点 的 理想 工具 。 但 是 ， 就 算 
它 能 对 返回 HTML 页 面 的 URL 发 起 请 求 ， 也 不 方便 对 页 面 内 容 或 者 页 面 上 执行 的 操作 进行 断言 。 
结果 HTML 里 的 内 容 最 好 能 够 精确 判断 ( 这 种 测试 很 脆弱 )。 不 过 你 无 法 轻易 判断 页 面 上 选中 的 
内 容 ， 或 者 执行 诸如 点 击 链接 或 提交 表单 这 样 的 操作 。 

对 于 HTML 应 用 程序 测试 ， 有 一 个 更 好 的 选择 一 一 Selenium ( www.seleniumhq.org )， 它 的 功 
能 远 不 止 提交 请 求 和 获取 结果 。 它 能 实际 打开 一 个 Web 浏 览 器 ， 在 浏览 器 的 上 下 文中 执行 测试 。 
Selenium 尽 量 接近 手动 执行 测试 ， 但 与 手工 测试 不 同 。Selenium 的 测试 是 自动 的 ， 而 且 可 以 重复 
运行 。 

为 了 用 Selenium 测 试 阅读 列表 应 用 程序 , 让 我 们 先 写 一 个 测试 来 获取 首页 , 为 新 书 
提交 表单 ， 随 后 判断 返回 的 页 面 里 是 否 包 含 新 添加 的 图 书 。 

首先 需要 把 Selenium 作 为 测试 依赖 添加 到 项 目 里 : 

testCompile("org.seleniumhq.selenium:selenium-java:2.45.0") 

现在 就 可 以 编写 测试 了 。 代 码 清单 4-6 是 一 个 基本 的 Selenium 测 试 模 板 ， 使 用 了 Spring Boot 
的 @WebIntegrationTest。 
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代码 清单 4-6 在 Spring Boot 里 使 用 Selenium 测 试 的 模板 


GRunWith(SpringJUnit4ClassRunner.class) 
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GSpringApplicationConfiguration( 2: car 

classes-ReadingListApplication.class) Fi Be La H 
GWebIntegrationTest(randomPort-true) a RI 
public class ServerWebTests ( 


private static FirefoxDriver browser; 
注入 端口 号 
GValue("$(local.server.port)") < —— 


private int port; 


GBeforeClass 
public static void openBrowser() { 
browser - new FirefoxDriver(); 
browser.manage().timeouts() Rc & Firefox 
.implicitlyWait(10, TimeUnit.SECONDS); 驱动 
} 


@AfterClass 
public static void closeBrowser() { 
browser.quit(); < 一 一 一 


) | 关闭 浏览 器 
} 


和 之 前 更 简单 的 Web 测 试 一 样 , 这 个 类 添加 了 @webIntegrationTest 注 解 ,将 randomPort 
设置 为 true， 这 样 应 用 程序 启动 后 会 运行 一 个 监听 随机 端口 的 服务 器 。 同 样 ， 端 口号 注入 port 
届 性 ， 这 样 我 们 就 能 用 它 来 构造 指向 运行 中 应 用 程序 的 URL 了 了 。 

静态 方法 openBrowser () 会 创建 一 个 FirefoxDriver 的 实例 ， 它 将 打开 Firefox 浏 览 器 ( 需 
要 在 运行 测试 的 服务 器 上 安装 该 浏览 器 ), 我 们 的 测试 方法 将 通过 FirefoxDriver 实 例 来 执行 浏 
览 器 操作 。 在 页 面 上 查找 元 素 时 , FirefoxDriver 配 置 了 10 秒 的 等 候 时 间 ( 以 防 元 素 加 载 过 慢 )。 
测试 执行 完毕 ,我 们 需要 关闭 Firefox 浏 览 右 。 此 要 在 closeBrowser() 里 要 调用 
FirefoxDriver 实 例 的 quit () 方 法 ， KAN AAT o 
选择 浏览 器 ”虽然 我 们 用 Firefox 进 行 了 测试 ， 但 Selenium 还 提供 了 不 少 其 他 浏览 器 

的 驱动 ， 包 括 IE、Google 的 Chrome， 还 有 Apple 的 Safari。 测 试 可 以 使 用 其 他 浏览 器 。 你 

也 可 以 使 用 你 想 支 持 的 各 种 浏览 器 ， 这 也 许 也 是 个 不 错 的 想法 。 

现在 可 以 开始 编写 测试 方法 了 ,给 你 提 个 醒 ， 我 们 想 要 加 载 首 页 ， 填充 并 发 送 表 单 ， 然 后 判 
断 登 录 的 页 面 是 否 包含 刚刚 添加 的 新 书 。 代 码 清 单 4-7 演 示 了 如 何 用 Selenium 实 现 这 个 功能 。 


代码 清单 4-7 用 Selenium 测 试 阅读 列表 应 用 程序 





























@Test 
public void addBookToEmptyList() { 
String baseUrl = "http://localhost:" + port; 
获取 主页 
browser.get(baseUrl); 二 一 


assertEquals("You have no books in your book list", 
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判断 图 书 列表 


EZ zs 
browser.findElementByTagName("div").getText()); 是 否 为 空 


browser.findElementByName("title") 

.SendKeys ("BOOK TITLE"); 

browser.findElementByName ("author") 

.SendKeys ("BOOK AUTHOR"); 

browser.findElementByName("isbn") 

.sendKeys ("1234567890") ; 

browser.findElementByName ("description") 

.SendKeys ("DESCRIPTION"); 

browser.findElementByTagName("form") 
.Submit(); < 一 


填充 并 发 送 表 














WebElement dl = 
browser.findElementByCssSelector("dt.bookHeadline"); 
assertEquals("BOOK TITLE by BOOK AUTHOR (ISBN: 1234567890)", 
dl.getText()); 
WebElement dt - 
browser.findElementByCssSelector("dd.bookDescription"); 
assertEquals("DESCRIPTION", dt.getText()); < 一 一 判断 列表 中 是 


否 包 含 新 书 

该 测试 方法 所 做 的 第 一 件 事 是 使 用 FirefoxDrivez 来 发 起 GET 请 求 ， 获 取 阅 读 列 表 的 主页 ， 
随后 查找 页 面 里 的 一 个 <aiv> 元 素 ， 从 它 的 文本 里 判断 列表 里 没有 图 书 。 

接 下 来 的 几 行 查找 表单 里 的 元 素 ， 使 用 驱动 的 sendKeys () 方 法 模拟 敲 击 键盘 事件 ( 实际 上 
就 是 用 给 定 的 值 填充 那些 表单 域 )。 最后， 找到 <form> 元 素 并 提交 。 

提交 的 表单 经 处 理 后 , 浏览 器 就 会 跳 到 一 个 页 面 ， 上 面 的 列表 包含 了 新 添加 的 图 书 。 因 此 最 
后 几 行 查找 列表 里 的 <at> 和 <ddq> 元 素 ， 判 断 其 中 是 否 包含 测 试 表单 里 提交 的 数据 。 

运行 测试 时 ,你 会 看 到 浏览 右 打开 ， 加载 阅读 列表 应 用 程序 。 如 果 够 仔细 ,你 还 会 看 到 填充 
表单 的 过 程 ， 就 好 像 幽 灵 在 操作 ， 当 然 ， 并 没有 幽灵 使 用 你 的 应 用 程序 一 一 这 只 是 一 个 测试 。 

这 个 测试 里 最 值得 注意 的 是 ，ewebIintegrationTest 可 以 为 我 们 启动 应 用 程序 和 服务 器 ， 
这 样 Selenium 才 可 以 用 Web 浏 览 器 执行 测试 。 但 真正 有 趣 的 是 你 可 以 使 用 IDE 的 测试 功能 来 运行 
测试 ， 运 行 几 次 都 行 ， 无 需 依赖 构建 过 程 中 的 某 些 搬 件 启动 服务 器 。 

要 是 你 觉得 使 用 Selenium 进 行 测试 很 实用 ， 可 以 阅读 Yujun Liang 和 Alex Collinsff) Selenium 
WebDriver in Practice ( http://manning.com/liang/ )， 该 书 更 深入 地 讨论 了 Selenium 测 试 的 细节 。 


} 





















































4.4 小 结 


测试 是 开发 高 质量 软件 的 重要 一 环 。 没 有 好 的 测试 , 你 永远 无 法 保证 应 用 程序 能 像 期 望 的 那 
样 运行 。 
单元 测试 专注 于 单一 组 件 或 组 件 中 的 一 个 方法 ， 此 处 并 不 一 定 要 使 用 Spring。Spring 提 供 了 
一 些 优势 和 技术 一 一 松 耦 合 、 依 赖 注入 和 接口 驱动 设计 。 这 些 都 简化 了 单元 测试 的 编写 。 但 Spring 
不 用 直接 涉足 单元 测试 。 
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集成 测试 会 涉及 众多 组 件 ， 这 时 就 需要 Spring 帮忙 了 。 实 际 上 ， 如 果 Spring 在 运行 时 负责 拼 
装 那些 组 件 ， 那 么 Spring 在 集成 测试 里 同样 应 该 肩负 这 一 职责 。 

Spring Framework 以 JUnit 类 运行 器 的 方式 提供 了 集成 测试 支持 ，JUnit 类 运行 器 会 加 载 Spring 
应 用 程序 上 下 文 , 把 上 下 文 里 的 Bean 注 入 测试 。Spring Boot 在 Spring 的 集成 测试 之 上 又 增加 了 配置 
加 载 器 ， 以 Spring Boot 的 方式 加 载 应 用 程序 上 下 文 ， 包 括 了 对 外 置 属性 的 支持 和 Spring Boot 日 志 。 

Spring Boot 还 支持 容器 内 测试 Web 应 用 程序 ,让 你 能 用 和 生产 环境 一 样 的 容器 启动 应 用 程序 。 
这 样 一 来 ， 测 试 在 验证 应 用 程序 行为 的 时 候 ， 会 更 加 接近 真实 的 运行 环境 。 

此 时 我 们 已 经 构建 了 一 个 相当 完整 的 应 用 程序 ( 虽然 有 点 简单 )， 它 利用 Spring Boot 的 起 步 
依赖 和 自动 配置 来 处 理 低级 工作 ， 让 我 们 专心 开发 应 用 程序 。 我 们 也 看 到 了 如 何 使 用 Spring Boot 
的 支持 来 测试 应 用 程序 。 在 后 续 几 章 里 ,我 们 会 看 到 一 些 不 同 的 东西 ， 了 解 让 Spring Boot 应 用 程 
序 开 发 更 加 简单 的 Groovy。 在 第 5 章 , 我 们 会 先 了 解 Grails 框 架 的 一 些 特性 , 看 看 它们 在 Spring Boot 
中 的 用 途 。 






































Groovy 5 Spring Boot CLI 








本 章 内 容 

口 自动 依赖 与 import 

口 获取 依赖 

口 测试 基于 CLI 的 应 用 程序 








有 些 东西 真 的 很 适合 在 一 起 : 花生 桨 和 果 桨 ,Abbott 和 Costello"， 电 内 和 雷鸣 ,牛奶 和 饼干 。 
每 样 东西 都 很 棒 ， 但 搭配 起 来 就 更 赞 了 。 

到 目前 为 止 ， 我 们 已 经 看 到 了 Spring Boot 带 来 的 不 少 好 东西 ， 包 括 自动 配置 和 起 步 依赖 。 要 
是 再 搭配 上 Groovy 的 优雅 ， 就 能 起 到 一 加 一 大 于 二 的 效果 。 

在 本 章 中 ,我 们 会 了 解 Spring Boot CLI。 这 是 一 个 命令 行 工 具 , 将 强大 的 Spring Boot 和 Groovy 
结合 到 一 起 ， 针 对 Spring 应 用 程序 形成 了 一 套 简 单 而 又 强大 的 开发 工具 。 为 了 演示 Spring Boot 
CLI 的 强大 之 处 ， 我 们 会 回 到 第 2 章 的 阅读 列表 应 用 程序 ， 利 用 CLI 的 优势 ， 以 Groovy 重 写 这 个 
应 用 程序 。 


5.1 开发 Spring Boot CLI 应 用 程序 


大 部 分 针对 JVM 平 台 的 项 目 都 用 Java 语 言 开 发 ,引入 了 诸如 Maven 或 Gradle 这 样 的 构建 系统 ， 
以 生成 可 部 署 的 产物 。 实 际 上 ， 我 们 在 第 2 章 开 发 的 阅读 列表 应 用 程序 就 遵循 这 套 模 型 。 

最 近 版 本 的 Java 语 言 有 不 少 改 进 。 然 而 ， 即 便 如 此 ，Java 还 是 有 一 些 严 格 的 规则 为 代码 增加 
了 不 少 噪声 。 行 尾 分 号 、 类 和 方法 的 修饰 符 ( 比如 public 和 private )、getter 和 setter 方 法 ， 还 
有 import 语 句 在 Java 中 都 有 自己 的 作用 ,但 它们 同 代码 的 本 质 无 关 ， 因 而 造成 了 干扰 。 从 开发 
者 的 角度 来 看 ,代码 噪声 是 阻力 编写 代码 时 是 阻力 , 试图 阅读 代码 时 更 是 阻力 。 如 果 能 消除 
一 部 分 代码 噪声 ， 代 码 的 开发 和 阅读 可 以 更 加 方便 。 

同 理 ，Maven 和 Gradle 这 样 的 构建 系统 在 项 目 中 也 有 自己 的 作用 ， 但 你 还 得 为 此 开发 和 维护 
构建 说 明 。 如 果 能 直接 构建 ， 项 目 也 会 更 加 简单 。 































































































(D 两 位 都 是 美国 的 喜剧 演员 ， 详 见 https://en.wikipedia.org/wiki/Abbott and_Costello。 一 -一 译 者 注 





5.1 开发 Spring Boot CLI 应 用 程序 81 








在 使 用 Spring Boot CLI 时 ， 没 有 构建 说 明文 件 。 代 码 本 身 就 是 构建 说 明 ， 提 供 线索 指引 CLI 
解析 依赖 ， 并 生成 用 于 部 署 的 产物 。 此 外 ， 配 合 Groovy，Spring Boot CLI 提 供 了 一 种 开发 模型 ， 
消除 了 几乎 所 有 代码 噪声 ， 带 来 了 畅通 无 阻 的 开发 体验 。 

在 最 简单 的 情况 下 ,编写 基于 CLI 的 应 用 程序 就 和 编写 第 1 章 里 的 Groovy 脚 本 一 样 简单 .不 过 ， 
要 用 CLI 编 写 更 完整 的 应 用 程序 ， 就 需要 设置 一 个 基本 的 项 目 结构 来 容纳 项 目 代 码 。 我 们 马上 用 
它 重 写 阅读 列表 应 用 程序 。 

































































5.1.1 设置 CLI 项 目 


我 们 要 做 的 第 一 件 事 是 创建 目录 结构 , 容纳 项 目 。 与 基于 Maven 或 Gradle 的 项 目 不 同 ,Spring 
Boot CLI 项 目 并 没有 严格 的 项 目 结构 要 求 。 实 际 上 ， 最 简单 的 Spring Boot CLI 应 用 程序 就 是 一 个 
Groovy 脚 本 ,可 以 放 在 文件 系统 的 任意 目录 里 。 对 阅读 列表 应 用 程序 而 言 ， 你 应 该 创建 一 个 干净 
的 新 目录 来 存放 代码 ， 把 它们 和 你 电脑 上 的 其 他 东西 分 开 。 

$ mkdir readinglist 

此 处 我 将 目录 命名 为 readinglist， 但 你 可 以 随意 命名 。 比 起 找 个 地 方 放置 代码 ， 名 字 并 不 
重要 。 

我 们 还 需要 两 个 额外 的 目录 存放 静态 Web 内 容 和 Thymeleaf 异 板 。 在 readinglist 目 录 里 创建 两 
个 新 的 目录 ， 名 为 static 和 templates。 

$ cd readinglist 


$ mkdir static 
$ mkdir templates 
































这 些 目录 的 名 字 和 基于 Java 的 项 目 中 src/main/resources 里 的 目录 同名 。 虽 然 Spring Boot 并 不 像 
Maven 和 Gradle 那 样 , 对 目录 结构 有 严格 的 要 求 , 但 Spring Boot 会 自动 配置 一 个 Spring Resource- 
HttpRequestHandler 查 找 static 目 录 (还 有 其 他 位 置 ) 的 静态 内 容 。 还 会 配置 Thymeleaf 来 解析 
templates 目 录 里 的 模板 。 

说 到 静态 内 容 和 Thymeleaf 模 板 ， 那些 文件 的 内 容 和 我 们 在 第 2 章 里 创建 的 一 样 。 因 此 你 不 用 
担心 稍 后 无 法 将 它们 回忆 起 来 ， 直 接 把 style.css 复 制 到 static 目 录 ， 把 readingList.html 复 制 到 
templates 目 录 即 可 。 

此 时 ， 阅 读 列表 项 目的 目录 结构 应 该 是 这 样 的 : 




































































L— static 
| L sgtyle.css 
L .. templates 
L .. readingList.html 


现在 项 目 已 经 设置 好 了 ， 我 们 准备 好 编写 Groovy 代 码 了 。 
5.1.2. ”通过 Groovy 消除 代码 噪声 
Groovy 本 身 是 种 优雅 的 语言 。 与 Java 不 同 ，Groovy 并 不 要 求 有 public 和 private 这 样 的 限 
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定 符 ， 也 不 要 求 在 行 尾 有 分 号 。 此 外 ， 归 功 于 Groovy 的 简化 属性 语法 ( GroovyBeans ), JavaBean 
的 标准 访问 方法 没有 存在 的 必要 了 。 

随 之 而 来 的 结果 是 ， 用 Groovy 编 写 Book 领 域 类 相当 简单 。 如 果 在 阅读 列表 项 目的 根 目录 里 
创建 一 个 新 的 文件 ， 名 为 Book.groovy， 那 么 在 这 里 编写 如 下 Groovy 类 。 


class Book { 
Long id 
String reader 
String isbn 
String title 
String author 
String description 














} 

如 你 所 见 ，Groovy 类 与 它 的 Java 类 相 比 ， 大 小 完全 不 在 一 个 量 级 。 这 里 没有 setter 和 getter 方 
法 ， 没 有 public 和 private 修 饰 符 ， 也 没有 分 号 。Java 中 常见 的 代码 噪声 不 复 存在 ， 剩 下 的 内 
容 都 在 描述 书 的 基本 信息 。 





Spring Boot CLI 中 的 JDBC 与 JPA 

你 也 许 已 经 注意 到 了 ，Book 的 Groovy 实 现 与 第 2 章 里 的 Java 实 现 有 所 不 同 ， 上 面 没有 添加 
JPA 注 解 。 这 是 因为 这 里 要 用 Spring 的 JdbcTemplate， 而 非 Spring Data JPA 访 问 数据 库 。 

有 好 几 个 不 错 的 理由 能 解释 这 个 例子 为 什么 选择 JDBC 而 非 JPA。 首 先 ， 在 使 用 Spring 的 
JabcTemplare 时 ， 我 可 以 多 用 几 种 不 同 的 方法 ， 展 示 Spring Boot 的 更 多 自动 配置 技巧。 选择 
JDBC 的 最 主要 原因 是 ，Spring Data JPA 在 生成 仓库 接口 的 自动 实现 时 要 求 有 一 个 .class 文 件 。 
当 你 在 命令 行 里 运行 Groovy 脚 本 时 ，CLI 会 在 内 存 里 编译 脚本 ， 并 不 会 产生 .class 文 件 。 因 此 ， 
当 你 在 CLI 里 运行 脚本 时 ，Spring Data JPA 并 不 适用 。 

但 CLI 和 Spring Data JPA 并 非 完全 不 兼容 。 如 果 使 用 CLI 的 jar 命 令 把 应 用 程序 打包 成 一 个 
JAR 文 件 ， 结 果 文 件 里 就 会 包含 所 有 Groovy 脚 本 编译 后 的 ,class 文件 。 当 你 想 部 署 一 个 用 CLI 开 
发 的 应 用 程序 时 ， 在 CLI 里 构建 并 运行 JAR 文 件 是 一 个 不 错 的 选择 。 但 是 如 果 你 想 在 开发 时 快 
速 看 到 开发 内 容 的 效果 ， 这 种 做 法 就 没 那么 方便 了 。 














既然 我 们 定义 好 了 Book 领 域 类 ， 就 开始 编写 仓库 接口 吧 。 首 先 ， 编 写 ReadingList- 
Repository 接 口 (位 于 ReadingListRepository.groovy ): 




















interface ReadingListRepository { 
List<Book> findByReader (String reader) 
void save(Book book) 


} 
除了 没有 分 号 ， 以 及 接口 上 没有 public 修 饰 符 ，ReadingListRepository 的 Groovy 版 本 
和 与 之 对 应 的 Java 版 本 并 无 二 致 。 最 显著 的 区 别 是 它 没 有 扩展 JpaRepository。 本 章 我 们 不 用 
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Spring Data JPA， 既 然 如 此 ， 我 们 就 不 得 不 自己 实现 ReadingListRepository。 代 码 清单 5-1 
就 是 JdbcReadingListRepository.groovy 的 内 容 。 





代码 清单 5-1 ReadingListRepository 的 Groovy JDBC 实 现 


@Repository 
class JdbcReadingListRepository implements ReadingListRepository { 


GAutowired 


JdbcTemplate jdbc $R— A 
JdbcTemplate 
List«Book» findByReader(String reader) ( 
jdbc .query ( 
"select id, reader, isbn, title, author, description " + 
"from Book where reader=?", 
( rs, row -> 
new Book(id: rs.getLong(1), 
reader: rs.getString(2), 
isbn: rs.getString(3), 
title: rs.getString(4), 
author: rs.getString(5), 
description: rs.getString(6)) 
) as RowMapper, 4— — RowMapper 
reader) Ba 
} 


void save(Book book) { 
jdbc.update("insert into Book " + 

"(reader, isbn, title, author, description) " + 
"salaoes (?, ?, 2p ?, 2)" 

book.reader, 

book.isbn, 

book.title, 

book.author, 

book.description) 





} 


以 上 代码 的 大 部 分 内 容 在 实现 一 个 典型 的 基于 JabcTemplate 的 仓库 。 它 自动 注入 了 一 个 
JdbcTemplate 对 象 的 引用 ， 用 它 查 询 数据 库 获 取 图 书 (在 fijndByReader () 方 法 里 )， 将 图 书 
保存 到 数据 库 (在 save () 方 法 里 )。 

因为 编写 过 程 采用 了 Groovy， 所 以 我 们 在 实现 中 可 以 使 用 一 些 Groovy 的 语法 糖 。 举 个 例子 ， 
在 fingByReader () 里 ,调用 query () 时 可 以 在 需要 RowMapper 实 现 的 地 方 传 入 一 个 Groovy 闭 
包 。" 此 外 ， 闭 包 中 创建 了 一 个 新 的 Book 对 象 ， 在 构造 时 设置 对 象 的 属性 。 

在 考虑 数据 库 持 久 化 时 ， 我 们 还 需要 创建 一 个 名 为 schema.sql 的 文件 。 其 中 包含 创建 Book 表 



































ir 























H) 做 类 似 的 事情 。 





D 为 了 公平 对 待 Java， 在 Java 8 里 我 们 可 以 用 Lambda ( 和 方法 引 
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所 需 的 SQL。 仓 库 在 发 起 查询 时 依赖 这 个 数据 表 : 


create table Book ( 

id identity, 

reader varchar(20) not null, 

isbn varchar(10) not null, 

title varchar(50) not null, 

author varchar(50) not null, 

description varchar(2000) not null 
)3 


稍 后 我 会 解释 如 何 使 用 schema.sql。 现 在 你 只 需要 知道 ， 把 它 放 在 Classpath 的 根 目录 ( 即 项 
目的 根 目录 )， 就 能 创建 出 查询 用 的 Book 表 了 。 

Groovy 的 所 有 部 分 差不多 都 齐全 了 , 但 还 有 一 个 Groovy 类 必须 要 写 。 这 样 Groovy 化 的 阅读 列 
表 应 用 程序 才 完 整 。 我 们 需要 编写 一 个 ReadingListController 的 Groovy 实 现 来 处 理 Web 请 
求 , 为 浏览 絮 提 供 阅 读 列表 。 在 项 目的 根 目 录 , 要 创建 一 个 名 为 ReadingListController.groovy 的 文 
件 ， 内 容 如 代码 清单 5-2 所 示 。 


代码 清单 5-2 处理 展示 和 添加 Web 请 求 的 ReadingListController 
@Controller 


GRequestMapping("/") 
class ReadingListController ( 

















String reader - "Craig" 
GAutowired Lm . ; 
ReadingListRepository readingListRepository ResdingbiStBebORItory 


GRequestMapping (method-RequestMethod.GET) 
def readersBooks (Model model) { 
List«Book» readingList - | 
readingListRepository.findByReader (reader) < 一 一 


if (readingList) ( 
model.addAttribute("books", readingList) «— — 设置 模型 
j 


视图 名 称 


Is] 





"readingList" «— — B 
} 


GRequestMapping (method-RequestMethod.POST) 
def addToReadingList(Book book) ( 
book.setReader(reader) 
readingListRepository.save (book) < 一 一 保存 图 书 


"redirect:/" < 一 
) POST 后 重 定向 


j 
这 个 ReadingListCcontroller 和 第 2 章 里 的 版 本 有 很 多 相似 之 处 。 主 要 的 不 同 在 于 , Groovy 
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的 语法 消除 了 类 和 方法 的 修饰 符 、 分 号 、 访 问 方法 和 其 他 不 必要 的 代码 噪声 。 

你 还 会 注意 到 ， 两 个 处 理 器 方法 都 用 def 而 非 String 来 定义 。 两 者 都 没有 显 式 的 return 语 
句 。 如 果 你 喜欢 在 方法 上 说 明 类 型 ， 喜欢 显 式 的 retrun 语 句 ， 加 上 就 好 了 一 一 Groovy 并 不 在 意 
这 些 细节 。 

在 运行 应 用 程序 之 前 ， 还 要 做 一 件 事 。 那 就 是 创建 一 个 新 文件 ， 名 为 Grabs.groovy， 内 容 包 
括 如 下 三 行 : 

@Grab ("h2") 


@Grab ("spring-boot-starter-thymeleaf") 
class Grabs {} 


稍 后 我 们 再 来 讨论 这 个 类 的 作用 , 现在 你 只 需要 知道 类 上 的 eGrap 注 解 会 告诉 Groovy 在 启动 
应 用 程序 时 自动 获取 一 些 依赖 的 库 。 

不 管 你 信 还 是 不 信 ,， 我 们 已 经 可 以 运行 这 个 应 用 程序 了 。 我 们 创建 了 一 个 项 目 目录 , 向 其 中 
复制 了 一 个 样式 表 和 Thymeleaf 模 板 ， 填 充 了 一 些 Groovy 代 码 。 接 下 来 , 用 Spring Boot CLI ( 在 项 
目 目录 里 ) 运行 即 可 : 


$ spring run . 


几 秒 后 ， 应 用 程序 完全 启动 。 打 开 浏 览 嚣 ， 访 问 http://localhost:8080。 如 果 一 切 正常 ， 你 应 
该 就 能 看 到 和 第 2 章 一 样 的 阅读 列表 应 用 程序 。 
成 功 啦 ! 只 用 了 几 页 纸 的 篇 幅 ， 你 就 写 出 了 简单 而 又 完整 的 Spring 应 用 程序 ! 
此 时 此 刻 你 也 许 会 好 奇 这 是 怎么 办 到 的 。 
口 没有 Spring 配 置 ，Bean 是 如 何 创 建 并 组 装 的 ? JabcTemplate Bean 又 是 从 哪 来 的 ? 
口 没有 构建 文件 ，Spring MVC 和 Thymeleaf 这 样 的 依赖 库 是 哪 来 的 ? 
O 没有 import 语 句 。 如 果 不 通 过 import 语 句 来 指定 具体 的 包 ，Groovy 如 何 解析 Jabc- 
Template 和 RequestMapping 的 类 型 ? 
口 没有 部 署 应 用 ，Web 服 务 器 从 何 而 来 ? 
实际 上 ， 我 们 编写 的 代码 看 起 来 不 止 缺 少 分 号 。 这 些 代 码 究竟 是 怎么 运行 起 来 的 ? 


5.1.3 发 生 了 什么 


你 可 能 已 经 猜 到 了 ，Spring Boot CLI 在 这 里 不 仅仅 是 便捷 地 使 用 Groovy 编 写 了 Spring 应 用 程 
序 。Spring Boot CLI 施 展 了 很 多 技能 。 

口 CLI 可 以 利用 Spring Boot 的 自动 配置 和 起 步 依赖 。 

口 CLI 可 以 检测 到 正在 使 用 的 特定 类 ， 自 动 解析 合适 的 依赖 库 来 支持 那些 类 。 

a CLI 知 道 多 数 常 用 类 都 在 哪些 包 里 ， 如果 用 到 了 这 些 类 , 它 会 把 那些 包 加 入 Groovy 的 默认 
包 里 。 

口 应 用 自动 依赖 解析 和 自动 配置 后 ，CLI 可 以 检测 到 当前 运行 的 是 一 个 Web 应 用 程序 ， 并 自 
动 引 入 骨 入 式 Web 容 器 ( 默认 是 Tomcat ) 供应 用 程序 使 用 。 
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仔细 想 想 ， 这 些 才 是 CLI 提 供 的 最 重要 的 特性 。Groovy 语 法 只 是 额外 的 福利 ! 

通过 Spring Boot CLI 运 行 阅读 列表 应 用 程序 ， 表 面 看 似 平 几 无 奇 ， 实 则 大 有 乾坤 。CLI 尝 试 
用 内 骨 的 Groovy 编 译 器 来 编译 Groovy 人 代码。 虽然 你 不 知道 ， 但 实际 上 ， 未 知 类 型 ( 比如 
JdbcTemplate、 Cont roller/A&RequestMapping ; 等 等 ) 最 终 会 使 代码 编译 失 败 。 

但 CLI 不 会 放弃 ， 它 知道 只 要 把 Spring Boot JDBC 起 步 依赖 加 入 Classpath 就 能 找到 
JadbcTemplate。 它 还 知道 把 Spring Boot 的 Web 起 步 依赖 加 入 Classpath 就 能 找到 Spring MVC 的 相 
关 类 。 因 此 ，CLI 会 从 Maven 仓 库 〈 默 认为 Maven 中 心 仓库 ) 里 获取 那些 依赖 。 

如 果 此 时 CLI 重 新 编译 , 那 还 是 会 失败 ， 因 为 缺少 Import 语句。 但 CLI 知 道 很 多 常用 类 的 包 。 
利用 定制 Groovy 编 译 器 默认 包 导 入 的 功能 之 后 ，CLI 把 所 有 需要 用 到 的 包 都 加 入 了 Groovy 编 译 需 
的 默认 导入 列表 。 

现在 CLI 可 以 尝试 再 一 次 编译 了 。 假 设 没有 其 他 CLI 能 力 范 围 外 的 问题 ( 比如 , 存在 CLI 不 知 
道 的 语法 或 类 型 错误 )， 代码 就 能 完成 编译 。CLI 将 通过 内 置 的 启动 方法 ( 与 基于 Java 的 例子 里 的 
main () 方 法 类 似 ) 运行 应 用 程序 。 

此 时 ，Spring Boot 自 动 配置 就 能 发 挥 作 用 了 。 它 发 现 Classpath 里 存在 Spring MVC ( 因为 CLI 
解析 了 Web 起 步 依赖 )， 就 自动 配置 了 合适 的 Bean 来 支持 Spring MVC, Xf ii AX Tomcat Bean 供 
应 用 程序 使 用 。 它 还 发 现 Classpath 里 有 JdbcTemplate， 所 以 自动 创建 了 JdbcTemplate Bean, 
注入 了 同样 自动 创建 的 DataSource Bean. 

说 起 DataSource Bean， 这 只 是 Spring Boot 自 动 配置 创建 的 众多 Bean 中 的 一 个 。Spring Boot 
还 自动 配置 了 很 多 Bean 来 支持 Spring MVC 中 的 Thymeleaf 模 板 。 正 是 由 于 我 们 使 用 eGrab 注 解 向 
Classpath 里 添加 了 H2 和 Thymeleaf， 这 才 触 发 了 针对 般 入 式 H2 数 据 库 和 Thymeleaf 的 自动 配置 。 

@Grap 注 解 的 作用 是 方便 添加 CLI 无 法 自动 解析 的 依赖 。 虽然 它 看 上 去 很 简单 ， 但 实际 上 这 
个 小 小 的 注解 作用 远 比 你 想象 得 要 大 。 让 我 们 仔细 看 看 这 个 注解 ， 看 看 Spring Boot CLI 是 如 何 通 
过 一 个 Artifact 名 称 找到 这 么 多 常用 依赖 ， 看 看 整个 依赖 解析 的 过 程 是 如 何 配 置 的 。 


5.2 ”获取 依赖 


在 Spring MVC 和 JdbcTemplate 的 例子 中 ,为 了 获取 必要 的 依赖 并 添加 到 Classpath 里 ， 
Groovy 编 译 触发 了 Spring Boot CLI。 这 是 错误 的 。 但 如 果 需 要 一 个 依赖 ， 而 没有 失败 代码 来 触发 
自动 依赖 解析 ， 又 或 者 所 需 的 依赖 CLI 不 知道 ， 那 该 怎么 办 ? 

在 阅读 列表 应 用 程序 中 , 我 们 需要 Thymeleaf 库 , 这 样 才能 编写 使 用 了 Thymeleaf 异 板 的 视图 。 
我 们 还 需要 H2 的 库 ， 这 样 才 能 拥有 租 入 式 的 H2 数 据 库 。 但 因为 没有 Groovy 代 码 会 直接 引用 
Thymeleaf 或 H2 的 类 ， 所 以 不 会 有 编译 错误 来 触发 自动 依赖 解析 。 因 此 ， 我 们 要 帮 一 帮 CLI， 在 
Grabs 类 上 添加 eGrap 依 赖 。 

该 把 @Grap 注 解放 在 哪里 ? 并 不 需要 像 我 们 这 样 ， 严 格 将 @Grab 注 解放 在 一 个 单 
独 的 类 上 。 它 们 在 ReadingListController 或 JdbcReadingListRepository 同 样 
有 效 。 不 过 ， 为 了 便于 组 织 管理 ， 最 好 创建 一 个 空 类 ， 把 所 有 eGrab 注 解放 在 一 起 。 这 
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样 方便 在 一 个 地 方 看 到 所 有 显 式 声明 的 依赖 。 

@Grab 注 解 源 自 Groovy Grape ( Groovy Adaptable Packaging Engine 或 Groovy Advanced 
Packaging Engine) 工具 。 从 本 质 上 来 说 ，Grape 人 允许 Groovy 脚 本 在 运行 时 下 载 依赖 ， 无 需 Maven 
或 Gradle 这 样 的 构建 工具 介入 。 除 了 支持 ecrap 注 解 ，Spring Boot CLI 还 用 Grape 来 获取 代码 中 推 
断 出 的 依赖 。 

使 用 eGrab 就 和 描述 依赖 一 样 简单 。 举 例 来 说 , 假设 你 想 往 项 目 里 添加 H2 数 据 库 ， 可 以 往 项 
目的 一 个 Groovy 脚 本 添加 如 下 @Grab 注 解 : 

@Grab (group="com.h2database", module-"h2", version="1.4.190") 

这 样 能 明确 地 声明 依赖 的 组 、 模 块 和 版 本 号 ,或 者 , 你 也 可 以 用 更 简洁 的 冒号 分 割 表示 依赖 ， 
这 和 Gradle 构 建 说 明 里 的 表示 方式 类 似 。 

@Grab ("com.h2database:h2:1.4.185") 

这 是 两 个 教科 书 式 的 例子 ， 但 Spring Boot CLI 对 ecrab 做 了 几 处 扩展 ， 用 起 来 更 简单 。 

很 多 依赖 不 再 要 求 指定 版 本 号 了 。 可 以 通过 下 面 的 方式 ， 用 ecrab 添 加 H2 数 据 库 依赖 : 

@Grab ("com.h2database:h2") 

确切 的 版 本 号 是 由 你 所 使 用 的 CLI 的 版 本 来 决定 的 。 如 果 用 的 是 Spring Boot CLI 
1.3.0.RELEASE， 那 么 H2 依 赖 的 版 本 会 解析 为 1.4.190。 

这 还 不 算 完 ， 很 多 常用 依赖 还 可 以 省 去 Group ID ， 直 接 在 eGrab 里 写 上 模块 的 D。 正 是 这 个 
特性 让 上 文 的 ecrab 注 解 成 功 加 载 了 H2。 

@Grab ("h2") 

那 你 该 如 何 获知 某 个 依赖 是 需要 Group ID 和 版 本 号 , 还 是 只 需要 Module ID 呢 ? 我 在 附录 D 中 
提供 了 一 个 完整 的 列表 ， 包 含 了 Spring Boot CLI 知 道 的 全 部 依赖 。 通 常 ， 你 可 以 先 试 一 下 只 写 
Module ID ， 如 果 这 样 不 行 ， 再 加 上 Group ID 和 版 本 号 。 

只 用 Module ID 来 表示 依赖 会 很 方便 ， 但 如 果 你 并 不 认可 Spring Boot 选 择 的 版 本 号 怎么 办 ? 
如 果 Spring Boot 的 起 步 依 赖 传递 引入 了 一 个 库 的 某 个 版 本 ,但 你 想 要 使 用 修正 了 bug 的 新 版 本 又 
该 如 何 呢 ? 


5.2.1 有 替 盖 默认 依赖 版 本 


Spring Boot 引 入 了 新 的 @GrabMetadata 注 解 , 可 以 和 ecGrab 搭 配 使 用 , 用 属性 文件 里 的 内 容 
来 覆盖 默认 的 依赖 版 本 。 

要 用 @GrabMetadata， 可 以 把 它 加 到 某 个 Groovy 脚 本 文件 里 ， 提 供 相应 的 属性 文件 来 覆盖 
依赖 元 数据 : 


QGGrabMetadata("com.myorg:custom-versions:1.0.0") 


这 会 从 Maven 仓 库 的 com/myorg 目 录 里 加 载 一 个 名 为 custom-versions.properties 的 文件 。 文 件 
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里 的 每 一 行 都 应 该 有 Group ID 和 Module ID 。 以 这 两 个 东西 为 键 名 ， 属 性 则 是 值 。 例 如 ， 要 把 H2 
的 默认 版 本 覆盖 为 1.4.186， 可 以 把 @GrabMetadata 指 向 一 个 包含 如 下 内 容 的 属性 文件 : 


com.h2database:h2=1.4.186 





























使 用 Spring IO 平 台 

你 可 能 希望 让 @GrabMetadata 使 用 Spring IO 平台 ( http://platform.spring.io/platform/ ) 上 定 
义 的 依赖 版 本 。 该 平台 提供 了 一 套 依赖 和 版 本 。 明 确 哪个 版 本 的 Spring 能 和 其 他 库 的 什么 版 本 
搭配 使 用 。Spring IO 平台 提供 的 依赖 和 版 本 是 Spring Boot 已 知 依赖 库 的 一 个 超 集 ， 包 含 了 很 多 
Spring 应 用 程序 经 常用 到 的 第 三 方 库 。 

如 果 你 想 在 Spring IO 平台 上 构建 Spring Boot CLI 应 用 程序 ， 只 需要 在 Groovy 脚 本 中 添加 如 
下 eGrabMetadata 即 可 。 


GGrabMetadata('io.spring.platform:platform-versions:1.0.4.RELEASE') 


这 会 覆盖 CLI 的 默认 依赖 版 本 ， 使 Spring IO 平台 定义 的 版 本 取而代之 。 


你 可 能 会 有 疑问 ，Grape 又 是 从 哪里 获取 所 有 这 些 依赖 的 呢 ? 这 是 可 配置 的 吗 ? 让 我 们 来 看 
看 你 该 如 何 管理 Grape 获取 依赖 的 仓库 集 。 


5.2.2. ”添加 依赖 仓库 


默认 情况 下 ，ecrab 声 明 的 依赖 是 从 Maven 中 心 仓 库 ( http://repol.maven.org/maven2/ ) 拉 取 
的 。 此 外 ，Spring Boot 还 注册 了 Spring 的 里 程 碑 及 快照 仓库 ， 以 便 获 取 Spring 项 目的 预 发 布 版 本 
依赖 。 对 很 多 项 目 而 言 ， 这 就 足够 了 。 但 要 是 你 的 项 目 需要 的 库 不 在 这 两 者 之 中 该 怎么 办 呢 ? 或 
者 你 的 工作 环境 在 公司 防火 墙 内 ， 必 须 使 用 内 部 仓库 又 该 如 何 ? 

没有 问题 。ecrabResolvez 注 解 可 以 让 你 指定 额外 的 仓库 ， 用 来 获取 依赖 。 

举 个 例子 ， 假 设 你 想 使 用 最 新 的 Hiberate， 而 最 新 的 Hibernate 版 本 只 能 从 JBoss 的 仓库 里 获 
取 到 。 那 么 你 需要 通过 ecrabResolver 来 添加 仓库 : 


GGrabResolver (name-'jboss', root- 
'https://repository.jboss.org/nexus/content/groups/public-jboss') 


这 里 通过 name 属 性 将 该 解析 器 命名 为 jboss， 通 过 *oot 属 性 来 指定 仓库 的 URL。 

你 已 经 了 解 了 Spring Boot CLI 是 如 何 编译 代码 以 及 自动 按 需 解析 已 知 依赖 库 的 。 在 eGrap 的 
支持 下 ，CLI 可 以 解析 各 种 它 无 法 自动 解析 的 依赖 。 基 于 CLI 的 应 用 程序 无 需 Maven 或 Gradle 构 建 
说 明文 件 ( 传统 方式 开发 的 Java 应 用 程序 需要 这 个 文件 )。 但 解析 依赖 和 编译 代码 并 不 是 构建 过 
程 的 全 部 ,项 目的 构建 通常 还 要 执行 自动 化 测试 ,要 是 没有 构建 说 明文 件 ,又 该 如 何 运行 测试 呢 ? 
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5.3 用 CLI 运行 测试 


测试 是 软件 项 目的 重要 组 成 部 分 ，Spring Boot CLI 当 然 没 有 忽略 测试 。 因 为 基于 CLI 的 应 用 
程序 并 未 涉及 传统 的 构建 系统 ， 所 以 CLI 提 供 了 一 个 test 命 令 来 运行 测试 。 

在 试验 test 命 令 前 ， 你 先 要 写 一 个 测试 。 测 试 可 以 放 在 项 目 中 的 任何 位 置 。 我 建议 将 其 与 
主要 组 件 分 开放 置 , 最 好 放 在 一 个 子 日 录 里 。 这 个 子 目 录 的 名 字 随 意 。 我 在 这 里 将 其 命名 为 tests: 

$ mkdir tests 

在 tests 目 录 里 ， 创 建 一 个 名 为 ReadingListControllerTest.groovy 的 新 Groovy 脚 本 ， 编 写 针 对 
ReadingListcontroller 的 测试 。 代 码 清单 5-3 是 个 简单 的 测试 ， 测 试 控制 器 能 否 正确 处 理 
HTTP GET 请 求 。 















































代码 清单 5-3 ”ReagdingListController 的 Groovy 测 试 


import org.springframework.test.web.servlet.MockMvc 

import static 
org.springframework.test.web.servlet.setup.MockMvcBuilders.* 
import static org.springframework.test.web.servlet.request. 
MockMvcRequestBuilders.* 
import static org.springframework.test.web.servlet.result. 


MockMvcResultMatchers.* 





import static org.mockito.Mockito.* 
class ReadingListControllerTest ( 


GTest 
void shouldReturnReadingListFromRepository() ( 
List«Book» expectedList = new ArrayList«Book»() 
expectedList.add(new Book( 
iar 1 
reader: "Craig", 
isbn: "9781617292545", 
title: "Spring Boot in Action", 
author: "Craig Walls", 





description: "Spring Boot in Action is ..." 模拟 
) ) ReadingListRe 
pository 
def mockRepo - mock(ReadingListRepository.class) 4 
when (mockRepo.findByReader("Craig")).thenReturn(expectedList) 
def controller = 
new ReadingListController(readingListRepository: mockRepo) 


MockMvc mvc = standaloneSetup(controller).build() 
mvc.perform(get("/")) 
.andExpect (view().name("readingList")) 
.andExpect (model().attribute("books", expectedList)) 


执行 并 测试 GET 


请 求 
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如 你 所 见 ， 这 就 是 个 简单 的 JUnit 测 试 , 使 用 了 Spring 的 模拟 MVC 测 试 支 持 功能 ,对 控制 器 发 











起 GET 请 求 。 最 先 设置 的 是 ReadingListRepository 的 一 个 模拟 实现 ， 它 会 返回 一 个 包含 单一 





Book 项 的 列表 。 随 





后 ， 测 试 创 建 了 一 个 ReadqingListcontroller 实 例 ， 将 模拟 仓库 注入 














readingListRepository 属 性 。 最 后 ， 配 置 了 一 个 MockMvc 对 象 ， 发 起 cET 请 求 ， 对 期 望 的 视 
图 名 称 和 模型 内 容 进行 断言 。 


但 是 ， 此 处 运行 
里 执行 测试 : 


$ spring test 








测试 要 比 说 明 测试 更 重要 。 使 用 CLI 的 test 命 令 ， 可 以 像 下 面 这 样 在 命令 行 


tests/ReadingListControllerTest.groovy 





本 例 中 ， 我 明确 选中 了 ReadingListcontrollerTest 作 为 要 运行 的 测试 。 如 果 tests/ 目 录 
里 有 多 个 测试 ， 你 想 要 全 部 运行 ， 可 以 在 test 命 令 中 指定 目录 和 名: 


$ spring test 


tests 











如 果 你 倾向 于 编写 Spock 说 明 而 非 JUnit 测 试 ， 那 么 你 一 定 会 很 高 兴 ， 因 为 CLI 的 test 命 令 也 





可 以 运行 Spock 说 明 ， 





代码 清单 -4 的 ReadingListControllerSpec 就 演示 了 这 一 功能 。 


代码 清单 5-4 ”测试 ReadingListController 的 Spock 说 明 


import org.springframework.test.web.servlet.MockMvc 


import static 


org.springframework.test.web.servlet.setup.MockMvcBuilders.* 


import static org.springframework.test.web.servlet.request. 


MockMvcRequestBuilders.* 


import static org.springframework.test.web.servlet.result. 





MockMvcResultMatchers.* 


import static org.mockito.Mockito.* 


class ReadingListControllerSpec extends Specification ( 


MockMvc mockMvc 
List«Book» expectedList 


def setup() 


( 


expectedList = new ArrayList«Book»() 
expectedList.add(new Book( 


ads 
reader: 


"Craig", 


isbn: "9781617292545", 
title: "Spring Boot in Action", 


author: 


"Craig Walls", 


description: "Spring Boot in Action is ..." 模拟 的 


) ) 


ReadingListRepository 


def mockRepo - mock(ReadingListRepository.class) q4 
when (mockRepo.findByReader("Craig")).thenReturn(expectedList) 


def controller = 
new ReadingListController(readingListRepository: mockRepo) 
mockMvc = standaloneSetup(controller).build() 
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} 


def "Should put list returned from repository into model"() ( 
when: 
def response - mockMvc.perform(get("/")) < 一 一 
执行 GET 请 求 
then: 
response.andExpect (view() .name ("readingList")) 
.andExpect (model().attribute("books", expectedList)) <4 





测试 结果 


} 





ReadingListControllersSpec 只 是 简单 地 把 ReadingListCcontrollerTest 从 JUnit 测 试 
翻译 成 了 Spock 说 明 。 如 你 所 见 ， 它 只 是 直 白 地 表述 了 这 么 一 个 过 程 。 对 “/” 出 现 GET 请 求 时 ， 
响应 中 应 该 包含 名 为 readingList 的 视图 。 模 型 里 的 books 键 所 对 应 的 就 是 期 待 的 图 书 列表 。 

Spock 说 明 也 可 以 通过 spring test tests 来 运行 ReadingListControllerSpec。 Zí 
Jr RISE-T JUnitffS WARA E — ft 

一 旦 写 好 代码 ， 通 过 了 全 部 测试 ， 你 就 该 部 署 项 目 了 。 让 我 们 来 看 看 Spring Boot CLI 是 如 何 
帮助 产生 一 个 可 部 署 的 产物 的 。 


5.4 ”创建 可 部 署 的 产物 


在 基于 Maven 和 Gradle 的 传统 Java 项 目 中 ,构建 系统 负责 产生 部 署 单 元 一 一 一 般 是 JAR 文 件 或 
WAR 文 件 。 然 而 ， 有 了 Spring Boot CLI, 我们 可 以 简单 地 通过 spring 命 令 在 命令 行 里 运行 应 用 
程序 。 

这 是 否 就 意味 着 要 部 署 一 个 Spring Boot CLI 应 用 程序 ， 必 须 在 服务 器 上 安装 CLI， 并 手工 在 
命令 行 里 启动 应 用 程序 呢 ? 在 部 署 生产 环境 时 ， 这 看 起 来 相当 不 方便 (不 用 说 ， 这 还 很 危险 )。 

在 第 8 章 里 我 们 会 讨论 更 多 部 署 Spring Boot 应 用 程序 的 方法 。 此 刻 ， 让 我 告诉 你 另 一 个 CLI 
窍门 。 针 对 基于 CLI 的 阅读 列表 应 用 程序 ， 在 命令 行 执行 如 下 命令 : 


$ spring jar ReadingList.jar . 

这 会 将 整个 项 目 打包 成 一 个 可 执行 的 JAR 文 件 , 包含 所 有 依赖 、Groovy 和 一 个 能 人 式 Tomcat。 
打包 完成 后 ， 就 可 以 像 下 面 这 样 在 命令 行 里 运行 了 (无 需 CLI): 

$ java -jar ReadingList.jar 

除了 可 以 在 命令 行 里 运行 外 ， 可 执行 的 JAR 文 件 也 能 部 署 到 多 个 平台 服务 器 (Platform as a 
Service, PaaS) 云 平台 里 ， 包 括 Pivotal Cloud Foundry 和 Heroku ， 在 第 8 章 里 你 会 看 到 相关 内 容 。 













































































5.5 小 结 
Spring Boot CLI 利 用 了 Spring Boot 自 动 配置 和 起 步 依 赖 的 便利 之 处 ， 并 将 其 发 扬 光 大 。 借 由 
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Groovy 语 言 的 优雅 ，CLI 能 让 我 们 在 最 少 的 代码 噪声 下 开发 Spring 应 用 程序 。 

本 章 中 我 们 彻底 重 写 了 第 2 章 里 的 阅读 列表 应 用 程序 ， 只 是 这 次 我 们 用 Groovy 把 它 写成 了 
Spring Boot CLI 应 用 程序 。 通 过 自动 添加 很 多 常用 包 和 类 的 import 语 句 ，CLIiFGroovy 更 优雅。 
它 还 可 以 自动 解析 很 多 依赖 库 。 

对 于 CLI 无 法 自动 解析 的 库 ， 基 于 CLI 的 应 用 程序 可 以 利用 Grape 的 eGrab 注 解 ， 不 用 构建 说 
明 也 能 显 式 地 声明 依赖 。Spring Boot 的 CLI 扩 展 了 eGrab 注 解 ， 针 对 很 多 常用 库 依赖 ， 只 需 声 明 
Module ID 就 可 以 了 。 

最 后 ， 你 还 了 解 了 如 何 用 Spring Boot CLI 来 执行 测试 和 构建 可 部 署 产物 ， 这 些 通常 都 是 由 构 
建 系 统 来 负责 的 。 

Spring Boot 和 Groovy 结 合 得 很 好 ， 两 者 的 简洁 性 相辅相成 。 在 第 6 章 ， 我 们 还 会 看 到 Spring 
Boot 和 Groovy 是 如 何 协同 的 Spring Boot 是 Grails 最 新 版 本 的 核心 。 



































第 6 章 


在 Spring Boot 中 使 用 Grails 








本 章 内 容 

a 使 用 GORM 持 和 久 化 数据 
口 定义 GSP 视 图 

口 Grails 3 和 Spring Boot 入 门 





我 小 时 候 ， 有 一 个 系列 电视 广告 ， 当 中 有 两 个 人 , 一 个 在 吃 巧克力 条 ， 男 一 个 在 吃 钢 子 里 的 
花生 桨 。 经 由 一 些 富有 喜剧 效果 的 小 事故 ， 两 个 人 撞 到 了 一 起 。 最 后 ， 花 生 着 和 巧克力 相 结合 。 

一 个 人 说 :“ 你 把 巧克力 弄 到 我 的 花生 桨 里 了 !” 另 一 个 人 回答 :“ 是 你 把 花生 桨 弄 到 我 的 巧 
克 力 上 了 !” 

在 一 开始 的 鸠 人 多 后 ,两 个 人 都 认同 花生 着 和 巧克力 结合 在 一 起 是 件 好 事 。 接 着 ， 旁 白 会 建议 
观众 试 试 Reese 牌 的 的 花生 酱 杯 《Peanut Butter Cup )。 

在 Spring Boot 刚 发 布 时 , 经 常 有 人 问 我 在 Spring Boot 和 Grails 之 间 该 如 何 选择 。 两 者 都 构建 于 
Spring Framework 之 上 ， 都 旨 在 简化 应 用 程序 的 开发 。 实 际 上 ， 它 们 就 像 花 生 桨 和 巧克力 。 两 个 
都 很 好 ， 上 具体 如 何 选 择 取决 于 个 人 爱好 。 

就 像 之 前 巧克力 和 花生 酱 的 争论 一 样 ， 事 实 上 并 不 必 从 中 选 出 一 个 来 。Spring Boot 和 Grails 
两 个 都 很 好 ， 完 全 可 以 结合 到 一 起 。 

在 本 章 中 ， 我 们 会 看 到 Grails 和 Spring Boot 之 间 的 联系 。 我 们 会 先 看 到 Spring Boot 中 Grails 对 
象 关系 映射 ( Grails Object Relational Mapping, GORM ) 和 Groovy 服 务 器 页 面 ( Groovy Server Page, 
GSP ) 这 样 的 Grails 特 性 ， 还 会 看 到 Grails 3 是 如 何 基 于 Spring Boot 重 写 的 。 


6.1 使 用 GORM 进行 数据 持久 化 


Grails 里 最 让 人 着 迷 的 恐 人 就 是 GORM 了 。GORM 将 数据 库 相 关 工 作 简 化 到 和 声明 要 持久 化 
的 实体 一 样 容易 。 例如, 代码 清单 6-1 演 示 了 阅读 列表 里 的 Book 该 如 何 用 Groovy 写 成 GORM 实 体 。 


代码 清单 6-1 GORM Book 实 体 


package readinglist 










































































import grails.persistence.* 
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这 是 一 个 GORM 实 体 
@Entity 人 


class Book { 


Reader reader 
String isbn 

String title 
String author 
String description 


} 

就 和 Book 的 Java 版 本 一 样 ， 这 个 类 里 有 很 多 描述 图 书 的 属性 。 但 又 与 Java 版 本 不 一 样 ， 这 里 
没有 分 号 、puplic 或 private 修 饰 符 、setter 和 getter 方 法 或 其 他 Java 中 常见 的 代码 噪声 。 是 Grails 
的 @Entity 注 解 让 这 个 类 变 成 了 GORM 实 例 。 这 个 简单 的 实体 可 干 了 不 少 事 , 包括 将 对 象 映射 到 
数据 库 ， 为 Book 添 加 持久 化 方法 ， 通 过 这 些 方 法 可 以 存 取 图 书 。 

要 在 Spring Boot 项 目 里 使 用 GORM， 必 须 在 项 目 里 添加 GORM 依 赖 。 在 Maven 中 ， 
<dependency> 看 起 来 是 这 样 的 : 


<dependency> 
«groupId»org.grails«/groupId» 
«artifactId»gorm-hibernate4-spring-boot«/artifactId» 
«version»1.1.0.RELEASE«/version» 

</dependency> 


一 样 的 依赖 ， 在 Gradle 里 是 这 样 的 : 

compile("org.grails:gorm-hibernate4-spring-boot:1.1.0.RELEASE") 

这 个 库 自 带 了 一 些 Spring Boot 自 动 配置 , 会 自动 配置 所 有 支持 GORM 所 需 的 Bean。 你 只 管 写 
代码 就 好 了 。 


GORM 在 Spring Boot 里 的 另 一 个 选择 
正如 其 名 , gorm-hibernate4-spring-boot 是 通过 Hibernate 开 启 GORM 数 据 持 久 化 的 。 






























































对 很 多 项 目 而 言 , 这 很 好 ,但 如 果 你 想 用 MongoDB, 那 你 会 对 Spring Boot 里 的 MongoDB GORM 
支持 很 感 兴 趣 。 

它 的 Maven 依 赖 是 这 样 的 : 

<dependency> 


«groupId»org.grails«/groupId» 
«artifactId»gorm-mongodb-spring-boot«/artifactId» 
«version»1.1.0.RELEASE«/version-» 

</dependency> 


下 面 是 相同 的 Gradle 依 赖 : 

compile("org.grails:gorm-mongodb-spring-boot:1.1.0.RELEASE") 

GORM 的 工作 原理 要 求实 体 类 必须 用 Groovy 来 编写 。 我 们 已 经 在 代码 清单 6-1 里 写 了 一 人 
Book 实 体 ， 下 面 再 写 一 个 Reader 实 体 ， 如 代码 清单 6-2 所 示 。 
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代码 清单 6-2 GORM Reader 实 体 


package readinglist 


import grails.persistence.* 


impor 
impor 


org.springframework.security.core.GrantedAuthority 


org.springframework.security.core.authority.SimpleGrantedAuthority 


import org.springframework.security.core.userdetails.UserDetails 





QGEntity < 一 一 一 
class Reader implements UserDetails ( 这 是 一 个 实体 
String username 
String fullname 
String password 
Collection«? extends GrantedAuthority» getAuthorities() ( 


Arrays.asList(new SimpleGrantedAuthority ("READER")) 


boolean 
true 


boolean 
true 


boolean 
true 


boolean 
true 


} 


现在 , 我 们 的 阅读 列表 应 用 程序 里 有 了 两 个 GORM 实 体 , 我 们 需要 重 写 剩 下 的 应 用 程序 来 使 


isAccountNonExpired() ( I a 
实现 了 


UserDetails 


isAccountNonLocked() ( 


isCredentialsNonExpired() { 


isEnabled() ( 























用 这 两 个 实体 。 因 为 使 用 Groovy 是 如 此 令 人 愉悦 (和 Grails 十 分 相似 )， 所 以 其 他 类 我 们 也 会 用 











Groovy 来 编写 。 

















首先 是 ReadingListcontroller， 如 代码 清单 6-3 所 示 。 


代码 清单 6-3 Groovy 的 ReadingLi stController 


package readinglist 


import org.springframework.beans.factory.annotation.Autowired 


import 


org.springframework.boot.context.properties.ConfigurationProperties 
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import org.springframework.http.HttpStatus 

import org.springframework.stereotype.Controller 

import org.springframework.ui.Model 

import org.springframework.web.bind.annotation.ExceptionHandler 
import org.springframework.web.bind.annotation.RequestMapping 
import org.springframework.web.bind.annotation.RequestMethod 
import org.springframework.web.bind.annotation.ResponseStatus 


GController 

GRequestMapping("/") 
GConfigurationProperties("amazon") 
class ReadingListController ( 


GAutowired 
AmazonProperties amazonProperties 


GExceptionHandler(value-RuntimeException.class) 
GResponseStatus (value-HttpStatus.BANDWIDTH LIMIT EXCEEDED) 
def error() ( 

"error" 





pO RS (method-RequestMethod.GET) 查找 读者 的 全 
ef readersBooks (Reader reader, Model model) { " á 
List«Book» readingList = Book.findAllByReader (reader) 部 图 书 
model.addAttribute("reader", reader) 
if (readingList) ( 
model.addAttribute("books", readingList) 
model.addAttribute("amazonID", amazonProperties.getAssociateId()) 
j 


"readingList" 


GRequestMapping (method-RequestMethod. POST) 
def addToReadingList(Reader reader, Book book) ( 
Book.withTransaction ( 
book.setReader (reader) 
book.save() < 


} | 保存 一 本 书 


"redirect:/" 


} 


这 个 版 本 的 ReadingListController 和 第 3 章 里 的 相 比 ， 最 明显 的 不 同 之 处 在 于 ， 它 是 用 
Groovy 写 的 ， 没 有 Java 的 那些 代码 噪声 。 最 重要 的 不 同 之 处 在 于 ， 无 需 再 注 和 人 ReadingList- 
Repository， 它 直接 通过 Book 类 型 持久 化 。 

TEreadersBooks () 方 法 里 , 它 调 用 了 Book 的 findAllByReader () 静 态 方法 , 传人 了 指定 
的 读者 信息 。 虽 然 代 码 清单 6-1 没 有 提供 findaal1ByReaaer () 方 法 ， 但 这 段 代 码 仍然 可 以 执行 ， 
因为 GORM 会 为 我 们 实现 这 个 方法 。 
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haic addToReadingList () 方 法 使 用 了 静态 方法 withTransaction() 和 实例 方法 
save ()。 这 两 个 方法 也 是 GORM 提 供 的 ， 用 于 将 Book 保 存 到 数据 库 里 。 

Sim HOME 声明 一 些 属性 ， 在 Book 上 添加 eEntity 注 解 。 如 果 你 问 我 怎么 看 一 一 我 
觉得 这 笔 买 卖 很 划算 。 

Securityconfig 也 要 做 类 似 的 修改 ,通过 GORM 而 非 ReadingListRepository 来 获取 
Reader。 代 人 码 清单 6-4 就 是 新 的 SecurityConfig。 












































代码 清单 6-4 — Groovy 版 本 的 SecurityConfig 


package readinglist 


org.springframework.context.annotation.Configuration 
org.springframework.security.config.annotation.authentication. 
builders.AuthenticationManagerBuilder 
import org.springframework.security.config.annotation.web. 
builders.HttpSecurity 
import org.springframework.security.config.annotation.web. 
configuration.WebSecurityConfigurerAdapter 
import org.springframework.security.core.userdetails.UserDetailsService 


impor 
impor 


ct ct 











GConfiguration 
class SecurityConfig extends WebSecurityConfigurerAdapter ( 





void configure(HttpSecurity http) throws Exception ( 
http 

.authorizeRequests() 
.antMatchers("/").access("hasRole('READER')") 
.antMatchers("/**").permitAll() 

.and() 

.formLogin() 
.loginPage("/login") 
.failureUrl("/login?error-true") 


) 


void configure(AuthenticationManagerBuilder auth) throws Exception ( 


auth 
.userDetailsService( 
( username -» Reader.findByUsername(username) ) «L——— 根据 用 户 名 查 
as UserDetailsService) 找 读 者 


} 


除了 用 Groovy 重 写 ，securityconfig 里 最 明显 的 变化 无 疑 就 是 第 二 个 configure () 方 法 。 
如 你 所 见 ， 它 使 用 了 一 个 闭 包 (UserDetailsService 的 实现 类 )， 其 中 调用 静态 方法 fingdBy- 
Username () 来 查找 Reader， 这 个 功能 是 GORM 提 供 的 。 

你 也 许 会 好 奇 ce MA E RR ReadingListRepository 变 成 什么 
f? GORM 替 我 们 人 处理 了 所 有 的 持久 化 工作 ， ZiReadingListRepository[, 
它 的 实现 也 都 不 需要 了 。 我 想 你 会 同意 Tui 观点 。 
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应 用 程序 中 剩余 的 代码 也 应 该 用 Groovy 重 写 ， 这 样 才能 和 我 们 的 变更 相 匹 配 。 但 它们 和 
GORM 没 什么 关系 ,也 不 在 本 章 的 讨论 范围 内 。 如 果 想 要 完整 的 代码 ， 可 以 到 示范 代码 页 面 里 去 
下 载 。 

此 刻 ， 你 可 以 通过 各 种 运行 Spring Boot 应 用 程序 的 方法 来 启动 阅读 列表 应 用 程序 。 启 动 后 ， 
应 用 程序 应 该 能 像 从 前 一 样 工 作 。 只 有 你 我 知道 持久 化 机 制 已 经 被 改变 了 。 

除了 GORM，Grails 应 用 程序 通常 还 会 用 Groovy Server Pages 将 模型 数据 以 HTML 的 方式 呈现 
给 浏览 器 。6.2 节 应 用 程序 的 Grails 化 还 会 继续 。 我 们 会 把 Thymeleaf 符 换 为 等 价 的 GSP。 





























6.2 ”使 用 Groovy Server Pages 定义 视图 


到 目前 为 止 ， 我 们 都 在 用 Thymeleaf 模 板 定 义 阅 读 列表 应 用 程序 的 视图 。 除 了 Thymeleaf， 
Spring Boot 还 支持 Freemarker 、Velocity 和 基于 Groovy 的 模板 。 无 论 选择 哪 种 模板 ， 你 要 做 的 就 是 
添加 合适 的 起 步 依赖 ,在 Classpath 根 部 的 templates/ 目 录 里 编写 模板 。 自动 配置 会 处 理 剩 下 的 事情 。 

Grails 项 目 也 提供 GSP 的 自动 配置 。 如果 你 想 在 Spring Boot 应 用 程序 里 使 用 GSP， 必须 向 项 目 
里 添加 Spring Boot 的 GSP 库 : 








Illi 
" 






































compile("org.grails:grails-gsp-spring-boot:1.0.0") 


和 Spring Boot 提 供 的 其 他 视图 模板 一 样 ， 库 放 在 Classpath 里 就 会 触发 自动 配置 ， 设 置 所 需 的 
视图 解析 器 ， 以 便 在 Spring MVC 的 视图 层 里 使 用 GSP。 

剩 下 的 就 是 为 应 用 程序 编写 GSP 模 板 了 。 在 阅读 列表 应 用 程序 中 ， 我 们 要 把 Thymeleaf 的 
readingList.html 文 件 用 GSP 的 形式 重 写 ， 放 在 readingList.gsp 文 件 ( fi F src/main/resources/ 
templates ) 里 。 代 码 清单 6-5 就 是 新 的 GSP 模 板 的 代码 。 


代码 清单 6-5 GSP 编写 的 阅读 列表 应 用 程序 主 视图 
<!DOCTYPE html> 
<html> 
<head> 
<title>Reading List</title> 
«link rel="stylesheet" href="/style.css"></link> 
</head> 























<body> 
<h2>Your Reading List</h2> 


«g:if test="${books}"> 罗列 图 书 
«g:each in-"$(books)" var-"book"- < 一 一 
«dl» 
«dt class-"bookHeadline"-» 
$(book.title) by $(book.author) 
(ISBN: $(book.isbn)") 
«/dt» 
«dd class-"bookDescription"-» 
«g:if test-"book.description"» 
$(book.description) 
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</g:if> 
<g:else> 
No description available 
</g:else> 
«/dd» 
«/dl» 
«/g:each» 
efg:lis 
«g:else» 
«p»You have no books in your book list«/p» 
«/g:else» 


«hr/» 


«h3»Add a book</h3> 
图 书 表单 
<form method="POST"> < 一 一 一 
«label for-"title"'»Title:«/label» 
«input type-"text" name-"title" 
value-"$(book?.title)"/»«br/» 
«label for-"author"»Author:«/label» 
«input type-"text" name-"author" 
value-"$(book?.author)]"/»«br/» 
«label for-"isbn"»ISBN:«/label- 
«input type-"text" name-"isbn" 
value-"$(book?.isbn)"/»«br/» 
«label for-"description"»Description:«/label»«br/» 
«textarea name-"description" rows="5" cols-"80"'» 
$(book?.description) 
«/textarea» CSRF 令 牌 
«input type="hidden" name-"$( csrf.parameterName)" < 
value-"$( csrf.token)" /> 
«input type-"submit" value-"Add Book" /» 
</form> 











</body> 
</html> 


如 你 所 见 ，GSP 模 板 中 使 用 了 表达 式 语言 引用 ( 用 ${} 包 围 的 部 分 ) 以 及 GSP 标 签 库 〈 例如 
<g:if> 和 <g:each> ) 这 并 不 是 Thymeleaf 那 样 的 纯 HTML。 但 如 果 习 惯用 JSP，, 你 会 很 熟悉 这 种 
方式 ， 而 且 会 觉得 这 是 一 个 不 错 的 选择 。 

代码 里 的 绝 大 部 分 内 容 和 第 2 章 、 第 3 章 的 Thymeleaf 和 模板 类 似 , 映射 GSP 模 板 上 的 元 素 。 但 是 
有 一 点 要 注意 , 你 必须 要 放 一 个 隐藏 域 , 其 中 包含 CSRF ( Cross-Site Request Forgery ) 令 牌 。Spring 
Security 在 提交 PosT 请 求 时 要 求 带 有 这 个 令 牌 ，Thymeleaf 在 呈现 HTML 时 会 自动 包含 这 个 令 牌 ， 
但 在 GSP 里 你 必须 在 隐藏 域 显 式 地 包含 它 。 

图 6-1 是 GSP 模 板 的 显示 效果 ， 其 中 添加 了 一 些 图 书 。 

虽然 GORM 和 GSP 这 样 的 Grails 特 性 很 吸引 人 , 让 Spring Boot 应 用 程序 更 简单 , 但 你 在 这 里 还 
不 能 真正 体验 Grails。 让 我 们 再 往 Spring Boot 的 花生 桨 里 放 一 点 Grails 巧 克 力 。 现 在 让 我 们 来 看 看 
Grails 3 如 何 将 两 者 合 二 为 一 ， 带 来 完整 的 Spring Boot 和 Grails 开 发 体验 。 
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图 6-1 使 用 了 GSP 模 板 的 阅读 列表 


6.3 结合 Spring Boot 与 Grails 3 


Grails 一 直 都 是 构建 于 Spring、Groovy、Hibemate 和 其 他 巨人 肩膀 之 上 的 高 阶 框架 。 到 了 Grails 
3，Grails 已 经 基于 Spring Boot, 带 来 了 令 人 愉悦 的 开发 体验 。Grails 开 发 者 和 Spring Boot 开 发 者 都 

要 使 用 Grails 3， 首 先 要 进行 安装 。 在 Mac OS X 和 大 部 分 Unix 系 统 上 ， 最 简单 的 安装 方法 是 
在 命令 行 里 使 用 SDKMAN: 


$ sdk install grails 


如 果 你 用 的 是 Windows, 或 者 无 法 使 用 SDKMAN, 就 需要 下 载 二 进 制 发 布 包 。 解压 后 要 将 bin 
目录 添加 到 系统 路 径 里 去 。 
无 论 用 哪 种 安装 方式 ， 你 都 可 以 在 命令 行 中 查看 Grails 的 版 本 ， 验 证 安装 是 否 成 功 : 


$ grails -version 


如 果 安 装 成 功 ， 现 在 就 可 以 创建 Grails 项 目 了 。 


6.3.1 创建 新 的 Grails 项 目 
在 Grails 项 目 中 ， 你 会 使 用 grails 命 令 行 工 具 执行 很 多 任务 ， 包 括 创建 项 目 。 要 创建 阅读 列 
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表 项 目 ， 可 以 这 样 使 用 grails 命 令 : 

$ grails create-app readinglist 

正如 这 个 命令 的 名 字 所 示 ，create-app 创 建 了 新 的 应 用 程序 项 目 。 这 个 例子 里 的 项 目 名 为 
readinglist。 

等 grails 工 具 创 建 完 应 用 程序 ， cd 到 了 readinglist 目 录 里 , 看 看 所 创建 的 内 容 吧 。 图 6-2 
应 该 就 是 你 看 到 的 项 目 结构 的 概览 。 

在 这 个 项 目 目 录 结 构 里 ， 你 应 该 认 出 了 一 些 熟 悉 的 东西 。 这 里 有 一 个 Gradle 的 构建 说 明文 件 
和 配置 ( build.gradle 和 gradle.properties )。src 目 录 里 还 有 一 个 标准 的 Gradle 项 目 结构 ,但 是 grails-app 
应 该 是 里 面 最 有 趣 的 目录 。 如 果 用 过 老 版 本 的 Grails， 你 就 会 知道 这 个 目录 的 作用 。 这 里 面 放 的 
是 你 写 的 控制 器 、 领 域 类 和 其 他 构成 Grails 项 目的 代码 。 




















|— build.gradle 
gradle 
L— wrapper 

|— gradle.properties 

| 一 gradlew 

|— gradlew.bat 

l— grails-app 

| |l— assets 

| | 一 conf 

| | 一 controllers 

| domain 

| į ii8n 

|  L init 

| |— services 

| “上 taglib 

| — utils 

| L— views 

src 

|l— integration-test 
main 

L— test 


图 6-2 Grails 3 项 目的 目录 结构 
如 果 再 深 挖 一 下 ， 打 开 build.gradle 文 件 ， 会 发 现 一 些 更 熟悉 的 东西 。 首 先 ， 构建 说 明文 件 里 
使 用 了 Spring Boot 的 Gradle 插 件 : 


apply plugin: "spring-boot" 


这 意味 着 你 能 像 使 用 其 他 Spring Boot 应 用 程序 那样 构建 并 运行 这 个 Grails 应 用 程序 。 
你 还 应 该 注意 到 ， 依 赖 里 有 不 少 有 用 的 Spring Boot 库 : 


dependencies ( 


| 














compile 


compile 
compile 


"org.springframework.boot 


"org. 


'org.springframework.boot: 
compile("org.springframework.boot: 


spring-boot-starter-logging' 
spring-boot-starter-actuator") 


:Spring-boot-autoconfigure" 
springframework.boot: 


spring-boot-starter-tomcat" 
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这 些 库 为 Grails 应 用 程序 提供 了 Spring Boot 的 自动 配置 、 日 志 , ffi Actuator KAA XX Tomcat. 

应 用 当 作 可 执行 TAR 运行 时 ， 这 个 Tomcat 可 以 提供 服务 。 

实际 上 , 这 是 一 个 Spring Boot 项 目 , 同时 也 是 Grails 项 目 , 因为 Grails 3 就 是 构建 在 Spring Boot 
的 基础 上 的 。 

运行 应 用 程序 

运行 Grails 应 用 程序 最 直接 的 方式 是 在 命令 行 里 使 用 grails 工 具 的 run-app 命 令 : 

$ grails run-app 

就 算 一 行 代码 都 还 没 写 , 我 们 也 能 运行 应 用 程序 , 在 浏览 器 里 进 一 旦 应 用 程序 启动 ， 
就 可 以 在 浏览 器 里 访问 http://localhost:8080。 你 应 该 能 看 到 类 似 图 6-3 的 页 








ece <> D è 
























ERE Welcome to Grails 
E eie Congratulations, you have successfully started your first Grails application! At the moment this 


App profile: web is the default page, feel free to modify it to either redirect to a controller or display whatever 
App version: 0.1 content you may choose. Below is a list of controllers that are currently deployed in this 


Grails version: d application, click on each to execute its default action: 


JVM version: 1.8.0. 31 s 
: TORO A Available Controllers: 
ARTEFACTS 

Controllers: 0 

Domains: 0 

Services: 3 

Tag Libraries: 14 

INSTALLED PLUGINS 

restResponder - 3.0.4 

core - 3.0.4 

it8n - 3.0.4 





图 6-3 ”全 新 的 Grails 应 用 程序 
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在 Grails 里 运行 应 用 程序 要 使 用 run-app 命 令 ,， 这 种 方式 已 经 用 了 很 多 年 ， 上 个 版 本 的 Grails 
也 是 这 样 。Grails 3 项 目的 Gradle 说 明 里 使 用 了 Spring Boot 的 Gradle 插 件 ， 你 还 可 以 用 各 种 运行 
Spring Boot 项 目的 方式 来 运行 这 个 应 用 程序 。 此 处 通过 Gradle 引 入 了 bootRun 任 务 : 

$ gradle bootRun 

你 还 可 以 构建 项 目 ， 运 行 生成 的 可 执行 JAR 文 件 : 


$ gradle build 






































$ java -jar build/lib/readingList-0.1.jar 


当然 ， 构 建 产生 的 WAR 文 件 可 以 部 署 到 你 喜欢 的 各 种 Servlet 3.0 容 器 里 。 

在 开发 早期 就 能 运行 应 用 程序 , 这 一 点 十 分 方便 ,能 帮 你 确认 应 用 程序 已 正确 初始 化 。 但 是 
这 时 应 用 程序 还 没 做 什么 有 意思 的 事情 ， 在 初始 化 后 的 项 目 上 做 什么 完全 取决 于 我 们 。 接 下 来 ， 
开始 定义 领域 模型 吧 。 














6.3.2 ”定义 领域 模型 


阅读 列表 应 用 程序 里 的 核心 领域 模型 是 Book 类 。 虽 然 我 们 可 以 手工 创建 Book.groovy 文 件 ， 
但 通常 还 是 用 grails 工 具 来 创建 领域 模型 类 比较 好 。 因 为 它 知 道 该 把 文件 放 到 哪里 ， 并 且 能 在 
同一 时 间 生 成 各 种 相关 内 容 。 


要 创建 Book 类 ， 我 们 会 使 用 grails 工 具 的 create-domain-class 命 令 : 












































$ grails create-domain-class Book 

这 条 命令 会 生成 两 个 源 文件 : 一 个 Book.groovy 文 件 和 一 个 BookSpec.groovy 文 件 。 后 者 是 一 
个 Spock 说 明 , 用 来 测试 Book 类 。 一 开始 这 个 文件 是 空 的 , 你 可 以 填 人 各 种 测试 内 容 来 验证 Book 
的 各 种 功能 。 
Book.groovy 文 件 里 定义 了 Book 类 ， 你 可 以 在 grails-app/domain/readingList 里 找到 这 个 文件 。 
它 一 开始 基本 没什么 内 容 : 

package readinglist 

class Book { 
































static constraints = ( 
} 
} 


我 们 需要 添加 一 些 字段 来 定义 一 本 书 ， 比 如 书 名 、 作 者 和 ISBN。 在 添加 了 这 些 字段 后 ， 
Book.groovy 看 起 来 是 这 样 的 : 


package readinglist 
class Book { 

















static constraints = ( 


) 
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String re 
String is 
String ti 


ader 
bn 
tle 


String author 


String de 


} 


scription 





静态 的 constraints 变 量 里 可 以 定义 各 种 附加 在 Book 实 例 上 的 验证 约束 。 本章 中 , 我 们 主要 
关注 阅读 列表 应 用 程序 的 构建 ， 看 看 如 何 基 于 Spring Boot 构 建 应 用 程序 ， 不 会 太 关注 验证 的 问题 。 
因此 ， 这 里 的 constraints 内 容 为 空 。 当 然 ， 如 果 有 需要 的 话 ， 你 可 以 随意 添加 约束 。 可 以 参考 
一 下 Grails in Action, Second Edition， 作 者 是 Glen Smith 和 Peter Ledbrook。” 

为 了 使 用 Grails ， 我 们 要 保持 阅读 列表 应 用 程序 的 简洁 ， 要 和 第 2 章 的 程序 一 致 。 因 此 ， 接 下 
来 我 们 要 创建 Reaqez 领 域 模型 ， 还 有 控制 需 。 


6.3.3 开发 Grails 控制 器 








有 了 领域 模型 ， 通 过 grails 工 具 创建 出 控制 器 就 很 容易 了 。 关 于 控制 器 ， 有 几 个 命令 可 供 


选择 。 





含 必要 功能 的 控 人 





























口 create-controller: 创建 空 控制 希 ， 让 开发 者 来 编写 控制 器 的 功能 。 

口 generate-controller: 生 成 一 个 控制 器 , 其 中 包含 特定 领域 模型 类 的 基本 CRUD 操 作 。 
O generate-all: 生成 针对 特定 领域 模型 类 的 基本 CRUD 控 制 希 ， 及 其 视图 。 
脚手架 控制 器 很 好 用 ， 也 是 Grails 中 比较 知名 的 特性 ， 但 我 们 仍然 会 保持 简洁 ， 写 一 个 仅 包 











央 器 ， 能 匹配 第 2 章 里 的 应 用 程序 功能 就 好 。 因 此 , 我 们 用 create-controller 








命令 来 创建 原始 的 控制 器 ， 然 后 填 人 所 需 的 方法 。 


$ grails create-controller ReadingList 














这 个 命令 会 在 grails-app/controllers/readingList 里 创建 一 个 名 为 ReadingListController 的 





HA : 


package readinglist 


class Readi 


ngListController ( 


def index() ( } 


} 


一 行 代码 都 不 用 改 ， 这 个 控制 器 就 能 运行 了 ， 虽 然 它 干 不 成 什么 事 。 此 时 ， 它 能 处 理发 往 























/readingList 的 请 求 ， 将 请 求 转 给 grails-app/views/readingList/index.gsp 里 定义 的 视图 ( 现在 还 没有 ， 





我 们 稍 后 会 创建 的 )。 
我 们 需要 控制 器 来 显示 图 书 列表 , 还 有 添加 新 书 的 表单 。 我 们 还 需要 提交 表单 ， 将 新 书 保存 


























到 数据 库 里 的 功能 。 下 面 的 代码 就 是 我 们 所 需要 的 ReadingListcont rollers 





(D 这 本 书 虽然 主 








讲 Grails 2， 但 你 在 Grails 2 里 了 解 到 的 大 部 分 内 容 都 适用 于 Grails 3。 
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代码 清单 6-6 ”改写 ReadingListController 


package readinglist 


import static org.springframework.http.HttpStatus.* 
import grails.transaction.Transactional 


class ReadingListController ( 


获取 图 书 填充 


def index() ( mi 
7 到 模型 里 


respond Book.list(params), model:[book: new Book()] 


) 


GTransactional 

def save(Book book) ( 
book.reader - 'Craig' 
book.save flush:true < 一 
redirect (action: "index") 


} 


保存 图 书 


) 

虽然 相 比 等 效 的 Java 控 制 器 ， 代 码 长 度 大 幅 缩短 ， 但 这 个 版 本 的 ReadaingListController 
功能 已 经 基本 完整 。 它 可 以 处 理发 往 /readingList 的 cET 请 求 ， 获 取 并 展示 图 书 列表 。 在 表单 提交 
后 ， 它 还 会 处 理 PosT 请 求 ， 保 存 图 书 ， 随 后 重 定向 回 index 动 作 ( 由 ingex() 方 法 来 处 理 )。 

太 不 可 思议 了 ， 我 们 已 经 基本 完成 了 Grails 版 本 的 阅读 列表 应 用 程序 。 剩 下 的 就 是 创建 一 个 
视图 ， 显 示 图 书 列表 和 表单 。 









































6.3.4 创建 视图 


Grails 应 用 程序 通常 都 用 GSP 模 板 来 做 视图 。 你 已 经 看 到 过 如 何在 Spring Boot 应 用 程序 里 使 用 
GSP 了 ， 因 此 ， 此 处 的 模板 并 不 会 和 6.2 节 里 的 模板 有 太 多 不 同 。 

我 们 要 做 的 是 ， 利 用 Grails 提 供 的 布局 设施 ， 将 公共 的 设计 风格 运用 到 整个 应 用 程序 里 。 如 
代码 清单 6-7 所 示 ， 这 就 是 个 很 简单 的 修改 。 


代码 清单 6-7 一 个 适用 于 Grails 的 GSP 模 板 ， 包 含 布局 
<!DOCTYPE html» 
«html» 
«head» 使 用 了 main 布 局 
«meta name-"layout" content="main"/> 


«title»Reading List«/title» 

«link rel-"stylesheet" 
href-"/assets/main.css?compile-false" /> 

«link rel-"stylesheet" 
href-"/assets/mobile.css?compile-false"  /» 

«link rel-"stylesheet" 
href-"/assets/application.css?compile-false" /> 

</head> 















































<body> 
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<h2>Your Reading List«/h2» 


列 出 图 书 
«g:if test-"$(bookList && !bookList.isEmpty())"» 


«g:each in-"$(bookList)" var-"book"-» 
<dl> 
<dt class="bookHeadline"> 
$(book.title)«/span» by $(book.author) 
(ISBN: $(book.isbn)") 
«/dt» 
«dd class-"bookDescription"- 
«g:if test-"$(book.description)"» 
$(book.description) 
«/g:if» 
«g:else- 
No description available 
«/g:else» 
</dd> 
«/dl» 
«/g:each» 
«/g:if» 





«g:else- 
«p»You have no books in your book list«/p» 
«/g:else» 


«hr/» 


«h3»Add a book</h3> 
图 书 表单 

«g:form action-"save"- < 一 一 
«fieldset class-"form"» 

«label for-"title"»Title:«/label» 

«g:field type="text" name-"title" value-"$(book?.title)"/»«br/» 

«label for-z"author"»Author:«/label» 

«g:field type-"text" name-"author" 
value-"$(book?.author)"/»«br/» 
«label for-"isbn"»ISBN:«/label- 
«g:field type="text" name-"isbn" value-"$(book?.isbn)"/»«br/» 
«label for-z"description"»Description:«/label»«br/» 
«g:textArea name-"description" value-"$(book?.description)" 

rows-"5" cols-"80"/» 





«/fieldset» 
«fieldset class-"buttons"- 
«g:submitButton name-"create" class-"save" 
value-"$(message(code: 'default.button.create.label', 
default: 'Create'))]" /> 
«/fieldset» 
«/g:form» 


</body> 
</html> 


在 <head> 元 素 里 移 除了 引用 样式 表 的 <1ink> 标 签 。 这 里 放 了 一 个 <meta> 标 签 , 5LA T Grails 
应 用 程序 的 main 布 局 。 这 样 一 来 ， 应 用 程序 就 能 用 上 Grails 的 外 观 了 ， 运 行 效果 如 图 6-4 所 示 。 
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eoe < 加 localhost © ô a E 








Your Reading List 
Knitting with Dog Hair: Better A Sweater From A Dog You Know and Love Than From A Sheep You'll Never Meet by Kendall 
Crolius (ISBN: 0312152906") 

w many times have you groomed your dog, looked at all the fur floating around your feet, and remarked to yourself that 
there is enough fur for a sweater? 
Add a book 


Title: 
Author: 


ISBN: | 
Description: 








(& Create 


图 6-4 ”应 用 通用 Grails 风 格 的 阅读 列表 应 用 程序 


虽然 Grails 风 格 比 之 前 用 的 简单 的 样式 表 更 吸引 眼球 。 但 很 显然 的 是 ， 要 让 阅读 列表 应 用 程 
序 更 好 看 , 还 有 一 些 工作 要 做 。 首 先 要 让 应 用 程序 和 Grails 不 那么 像 ， 和 我 们 的 想象 更 接近 一 点 。 
修改 应 用 程序 的 样式 表 在 本 书 的 讨论 范围 之 外 ， 但 如 果 你 对 样式 微调 感 兴趣 ， 可 以 在 grails-app/ 
assets/stylesheets 目 录 里 找到 样式 表 文 件 。 








6.4 hi 


Grails 和 Spring Boot 都 旨 在 让 开发 者 的 生活 更 简单 ,大 大 简化 基于 Spring 的 开发 模型 ， 因 此 两 
者 看 起 来 是 互相 竞争 的 框架 。 但 在 本 章 中 ， 我 们 看 到 了 两 者 如 何 结合 在 一 起 ， 综 合 优势 。 

我 们 了 解 了 如 何 向 典型 的 Spring Boot 应 用 程序 中 添加 GORM 和 GSP 视 图 ， 这 两 个 都 是 知名 的 
Grails 特 性 。GORM 是 Spring Boot 里 一 个 很 受 欢 迎 的 特性 ， 能 让 你 直接 针对 领域 模型 执行 持久 化 
操作 ， 消 除了 对 模型 仓库 的 需求 。 

随后 我 们 认识 了 Grails 3， 即 Grails 构 建 于 Spring Boot 之 上 的 最 新 版 本 。 在 开发 Grails 3 应 用 程 
序 时 ， 你 也 在 使 用 Spring Boot， 可 以 使 用 Spring Boot 的 全 部 特性 ， 包 括 自 动 配 置 。 

在 本 章 和 第 $ 章 里 ， 我 们 看 到 了 如 何 结合 Groovy 和 Spring Boot， 消 除 Java 语 言 无 法 避免 的 那 
些 代码 噪声 。 

在 第 7 章 ， 我们 要 将 关注 点 从 开发 Spring Boot 应 用 程序 转移 到 Spring Boot Actuator 上， 看 看 它 
如 何 帮 助 我 们 了 解 应 用 程序 的 运行 情况 。 





深入 Actuator 








本 章 内容 
O Actuator Web 端 点 
口 调整 Actuator 





口 保护 Actuator 


口 通过 shell 连 人 运行 中 的 应 用 程序 








你 有 没有 猜 过 包 好 的 礼物 盒 里 装 的 是 什么 东西 ? 你 会 摇 一 摇 ,， 拓 一 扩 ， 量 一 量 ,， 你 甚至 会 执 
着 于 里 面 到 底 有 什么 。 但 打开 盒子 那 一 刻 前 ， 你 没 办 法 确认 里 面 是 什么 。 

运行 中 的 应 用 程序 就 像 礼物 盒 。 你 可 以 刺探 它 ， 作 出 合理 的 推测 ， 猜 测 它 的 运行 情况 。 但 如 
何 了 解 真实 的 情况 呢 ? 有 没有 一 种 办 法 能 让 你 深入 应 用 程序 内 部 一 宕 究竟 ,了解 它 的 行为 , 检查 
它 的 健康 状况 ， 甚 至 触发 一 些 操 作 来 影响 应 用 程序 呢 ? 

在 本 章 中 ， 我 们 将 了 解 Spring Boot 的 Actuator。 它 提供 了 很 多 生产 级 的 特性 ， 比 如 监控 和 度 
Spring Boot 应 用 程序 。Actuator 的 这 些 特性 可 以 通过 众多 REST 端 点 、 远 程 shell 和 JMX 获 得 。 我 
们 先 来 看 看 Actuator 的 REST 端 点 ， 这 种 最 为 人 所 熟知 的 使 用 方式 提供 了 最 完整 的 功能 。 




















7.1 揭秘 Actuator 的 端点 


Spring Boot Actuator 的 关键 特性 是 在 应 用 程序 里 提供 众多 Web 端 点 ， 通 过 它们 了 解 应 用 程序 
运行 时 的 内 部 状况 。 有 了 Actuator， 你 可 以 知道 Bean 在 Spring 应 用 程序 上 下 文 里 是 如 何 组 装 在 一 
起 的 ， 掌 握 应 用 程序 可 以 获取 的 环境 属性 信息 ， 获 取 运 行 时 度量 信息 的 快照 …… 

Actuator 提 供 了 13 个 端点 ， 具 体 如 表 7-1 所 示 。 


表 7-1 Actuator 的 端点 


































































































HTTP 方 法 路 d jx 
GET fautoconfig 提供 了 一 份 自动 配置 报告 ， 记 录 哪 些 自动 配置 条 件 通过 了 ， 哪 些 没 通 过 
GET /configprops 描述 配置 属性 (包含 默认 值 ) 如 何 注入 Bean 
GET /beans 描述 应 用 程序 上 下 文 里 全 部 的 Bean， 以 及 它们 的 关系 
GET /dump 获取 线程 活动 的 快照 
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(E) 
HTTP 方 法 R € mo x 

GET /env 获取 全 部 环境 属性 
GET /env/{name} 根据 名 称 获取 特定 的 环境 属性 值 
GET fhealth 报告 应 用 程序 的 健康 指标 ， 这 些 值 由 HealthIndicator 的 实现 类 提供 
GET /info 获取 应 用 程序 的 定制 信息 ， 这 些 信息 由 info 打 头 的 属性 提供 
GET /mappings 描述 全 部 的 URI 路 径 ， 以 及 它们 和 控制 器 〈 包 含 Actuator 端 点 ) 的 映射 关系 
GET /metrics 报告 各 种 应 用 程序 度量 信息 ， 比 如 内 存 用 量 和 HTTP 请 求 计数 
GET /metrics/ (name) 报告 指定 名 称 的 应 用 程序 度量 值 
POST /shutdown 关闭 应 用 程序 ， 要 求 endpoints.shutdown.enabled 设 置 为 true 
GET /trace 提供 基本 的 HTTP 请 求 跟踪 信息 (HEER, HTTP) 





要 启用 Actuator 的 端点 ， 只 需 在 项 目 中 引入 Actuator 的 起 步 依赖 即 可 。 在 Gradle 构 建 说 明文 件 

















这 个 依赖 是 这 样 的 : 
compile 'org.springframework.boot: 


对 于 Maven 项 目 ， 引 入 的 依赖 是 这 样 各 


m 





«dependency» 


Spring-boot-starter-actuator' 


|l: 


«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-actuator«/artifactId» 


</dependency> 





亦 或 你 使 用 Spring Boot CLI， 可 以 使 用 如 下 ecrab 注 解 : 


GGrab('spring-boot-starter-actuator') 








无 论 Actuator 是 如 何 添加 的 ， 在 应 用 程序 运行 时 自动 配置 都 会 生效 。Actuator 会 开启 。 
表 7-1 中 的 端点 可 以 分 为 三 大 类 : 配置 端点 、 度 量 端点 和 其 他 端点 。 让 我 们 分 别 了 解 一 下 这 
些 端点 ， 从 提供 应 用 程序 配置 信息 的 端点 看 起 。 








7.1.1 查看 配置 明细 



































关于 Spring 组 件 扫描 和 自动 织 人 ， 最 常 遭 人 抱怨 的 问题 之 一 就 是 很 难看 到 应 用 程序 中 的 组 件 








是 如 何 装配 起 来 的 。Spring Boot 自 动 配置 让 这 个 问题 变 得 更 严重 ， 因 为 Spring 的 配置 更 少 了 。 在 
有 显 式 配 置 的 情况 下 ,你 至 少 还 能 看 到 XML 文件 或 者 配置 类 , 对 Spring 应 用 程序 上 下 文 里 的 Bean 


关系 有 个 大 概 的 了 解 。 
我 个 人 从 不 担心 这 个 问题 。 也 许 是 因 
组 件 的 映射 关系 。 




















为 我 意识 到 ， 在 Spring 出 现 之 前 ， 根 本 就 没有 应 用 程序 





但 是 ， 如 果 你 担心 自动 配置 隐藏 了 Spring 应 用 程序 上 下 文中 Bean 的 装配 细节 ， 那 么 我 要 告诉 
你 一 个 好 消息 ! Actuatorx 有 一 些 端点 不 仅 可 以 显示 组 件 映 射 关 系 ， 还 可 以 告诉 你 自动 配置 在 配置 


Spring 应 用 程序 上 下 文 时 做 了 哪些 决策 。 
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1. 获得 Bean 装 配 报告 

要 了 解 应 用 程序 中 Spring 上 下 文 的 情况 , 最 重要 的 端点 就 是 /beans。 它 会 返回 一 个 JSON 文 档 ， 
描述 上 下 文 里 每 个 Bean 的 情况 ， 包 括 其 Java 类 型 以 及 注入 的 其 他 Bean。 向 /beans( 在 本 地 运行 时 
是 http://localhost:8080/beans ) 发 起 GET 请 求 后 ， 你 会 看 到 与 代码 清单 7-1 示 例 类 似 的 信息 。 


代码 清单 7-1 /beans 端 点 提供 的 Spring 应 用 程序 上 下 文 Bean 信 息 
[ 


























"beans": [ 
{ 
"bean": "application", <—— Bean ID 
"dependencies": [], 
"resource": l "null", 资源 文件 
"Scope": "singleton", 
"type": "readinglist.Application$$EnhancerBySpringCGLIB$$f363c202" 
p 
{ 
"bean": "amazonProperties", 
"dependencies": [], 
"resource": "URL [jar:file:/../readinglist-0.0.1-SNAPSHOT.jar! 
/readinglist/AmazonProperties.class]", «— 
"Scope": "singleton", 
"type": "readinglist.AmazonProperties" 依赖 
Fr 
( 
"bean": "readingListController", 
"dependencies": [ «I —————— Bean 作 用 域 
"readingListRepository", 
"amazonProperties" 
js, 
"resource": "URL [jar:file:/../readinglist-0.0.1-SNAPSHOT.jar! 
/readinglist/ReadingListController.class]", 
"Scope": "singleton", 
"type": "readinglist.ReadingListController" 
Er 
{ 
"bean": "readerRepository", 
"dependencies": [ 
"(inner bean)s219df4f5", 
"(inner bean) #2c0e7419", 
"(inner bean)#7d86037b", 
"jpaMappingContext" 
Jiz 
"resource": "null", 
"scope": "singleton", 
"type": "readinglist.ReaderRepository" 4— Java 类 型 
Lj 
( 
"bean": "readingListRepository", 
"dependencies": [ 


"(inner bean)s98ce66", 
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"(inner bean)#1fd7add0", 
"(inner bean)#59faabb2", 
"jpaMappingContext" 
15 
"resource": "null", 
"Scope": "singleton", 
"type": "readinglist.ReadingListRepository" 
) 


1s 
"context": "application", 
"parent": null 
} 
] 


代码 清单 7-1 是 阅读 列表 应 用 程序 Bean 信 息 的 一 个 片段 。 如 你 所 见 ， 所 有 的 Bean 条 目 都 有 五 
类 信息 。 
口 bean: Spring 应 用 程序 上 下 文中 的 Bean 名 称 或 ID。 
O resource: .class 文 件 的 物理 位 置 ， 通 常 是 一 个 URL， 指 向 构建 出 的 JAR 文 件 。 这 会 随 着 
应 用 程序 的 构建 和 运行 方式 发 生变 化 。 
O dependencies: 当前 Bean 注 入 的 Bean ID 列表 。 
口 scope: Bean 的 作用 域 ( 通常 是 单 例 ， 这 也 是 默认 作用 域 )。 
口 type: Bean 的 Java 类 型 。 

虽然 Bean 报 告 不 用 具体 绘图 告诉 你 Bean 是 如 何 装 配 的 〈 例如， 通过 属性 或 构造 方法 )， 但 它 
帮 你 直观 地 了 解 了 应 用 程序 上 下 文中 Bean 的 关系 。 实 际 上 , 写 出 一 个 工具 , 把 Bean 报 告 处 理 一 下 ， 
用 图 形 化 的 方式 来 展现 Bean 关 系 , 这 并 不 难 。 请 注意 , 完整 的 Bean 报 告 会 包含 很 多 Bean, 还 有 很 
多 自动 配置 的 Bean， 画 出 来 的 图 会 非常 复杂 。 

2. 详解 自动 配置 

/beans 端 点 产生 的 报告 能 告诉 你 Spring 应 用 程序 上 下 文 里 都 有 哪些 Bean。/autoconfig 端 点 能 告 
诉 你 为 什么 会 有 这 个 Bean ， 或 者 为 什么 没有 这 个 Bean。 

正如 第 2 章 里 说 的 ，Spring Boot 自 动 配置 构建 于 Spring 的 条 件 化 配置 之 上 。 它 提供 了 众多 带 有 
@Conditional 注 解 的 配置 类 ， 根据 条 件 决定 是 否 要 自动 配置 这 些 Bean。/autoconfig 端 点 提供 了 
一 个 报告 ， 列 出 了 计算 过 的 所 有 条 件 ， 根 据 条 件 是 否 通过 进行 分 组 。 

代码 清单 7-2 是 阅读 列表 应 用 程序 自动 配置 报告 里 的 一 个 片段 ,里面 有 一 个 通过 的 条 件 ， 还 
有 一 个 没 通 过 的 条 件 。 


代码 清单 7-2 阅读 列表 应 用 程序 的 自动 配置 报告 
{ 
"positiveMatches": { < 一 一 成 功 条 件 






































































































































"DataSourceAutoConfiguration.JdbcTemplateConfiguration 
#jdbcTemplate": [ 
{ 


"condition": "OnBeanCondition", 
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"message": "@ConditionalOnMissingBean (types: 
org.springframework.jdbc.core.JdbcOperations; 
SearchStrategy: all) found no beans" 

j 
m 
Ts 
"negativeMatches": ( «r—— — 失败 条 件 
"ActiveMQAutoConfiguration": [ 
( 

"condition": "OnClassCondition", 

"message": "required GConditionalOnClass classes not found: 
javax.jms.ConnectionFactory,org.apache.activemq 
.ActiveMQConnectionFactory" 

j 
Js 


j 
j 





TEpos itiveMatchesHi, 你 会 看 到 一 个 条 件 , 决定 Spring Boot 是 否 自 动 配置 JdqbcTemplate 
Bean。 匹 配 到 的 名 字 是 DataSourceAutoConfiguration.JdbcTemplateConfiguration# 
jdbcTemplate， 这 是 运用 了 条 件 的 具体 配置 类 。 条 件 类 型 是 onBeancondition， 意味 着 条 件 
的 输出 是 由 某 个 Bean 的 存在 与 否 来 决定 的 。 在 本 例 中 , message 属 性 已 经 清晰 地 表明 了 该 条 件 是 
检查 是 否 有 Jdbcoperations 类 型 (JbpdcTemplate 实 现 了 该 接口 ) 的 Bean 存 在 。 如 果 没 有 配置 
这 种 Bean， 则 条 件 成 立 ， 创 建 一 个 zabcTemplate Bean. 

与 之 类 似 ， 在 negativeMatches 里 ， 有 一 个 条 件 决 定 了 是 否 要 配置 ActiveMQ 。 这 是 一 个 
OnClassCondition, ， 会 检查 Classpath 里 是 否 存 在 ActiveMoconnectionFactory o 为 
Classpath 里 没有 这 个 类 ， 条 件 不 成 立 ， 所 以 不 会 自动 配置 ActiveMQ。 

3. 查看 配置 属性 

除了 要 知道 应 用 程序 的 Bean 是 如 何 装配 的 , 你 可 能 还 对 能 获取 哪些 环境 属性 , 哪些 配置 属性 
注入 了 Bean 里 感 兴趣 。 

/env 端 点 会 生成 应 用 程序 可 用 的 所 有 环境 属性 的 列表 ， 无 论 这 些 属性 是 否 用 到 。 这 其 中 包括 
环境 变量 、JVM 属 性 、 命 令 行 参数 ， 以 及 applicaition.properties 或 application.yml 文 件 提 供 的 属性 。 

代码 清单 7-3 的 示例 代码 是 /env 端 点 获取 信息 的 一 个 片段 。 


代码 清单 7-3 /env 端 点 会 报告 所 有 可 用 的 属性 
{ 

"applicationConfig: [classpath:/application.yml]": { < 
"amazon.associate id": "habuma-20", 应 用 属性 
"error.whitelabel.enabled": false, 

"logging.level.root": "INFO" 

Jo 

"profiles": [], 


' E 
"servletContextInitParams": {}, 环境 变量 


"SystemEnvironment": ( 
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"BOOK HOME": "/Users/habuma/Projects/BookProjects/walls6", 
"GRADLE HOME": "/Users/habuma/.sdkman/gradle/current", 
"GRAILS HOME": "/Users/habuma/.sdkman/grails/current", 
"GROOVY HOME": "/Users/habuma/.sdkman/groovy/current", 

} 

"systemProperties": ( < 一 
PID" t682"; JVM 系 统 属性 
"file.encoding": "UTF-8", 
"file.encoding.pkg": "sun.io", 
"file.separator": "/", 


} 

} 

基本 上 ， 任 何 能 给 Spring Boot 应 用 程序 提供 属性 的 属性 源 都 会 列 在 /env 的 结果 里 ， 同 时 会 显 
示 具 体 的 属性 。 

代码 清单 7-3 中 的 属性 来 源 有 很 多 ,包括 应 用 程序 配置 ( application.yml ), Spring Profile、Servlet 
上 下 文 初 始 化 参数 、 系 统 环境 变量 和 JVM 系 统 属 性 。( 本 例 中 没有 Profile 和 Servlet 上 下 文 初 始 化 参 
数 。) 
属性 常用 来 提供 诸如 数据 库 或 API 密 码 之 类 的 敏感 信息 。 为 了 避免 此 类 信息 暴露 到 /env 里 ， 
所 有 名 为 password secret, key (或 者 名 字 中 最 后 一 段 是 这 些 ) 的 属性 在 /env 里 都 会 加 上 “*”。 
举 个 例子 ， 如 果 有 一 个 属性 名 字 是 database.password， 那 么 它 在 /env 中 的 显示 效果 是 这 样 的 : 

"database.password's'"s**sx*s 

/env 端 点 还 能 用 来 获取 单个 属性 的 值 ， 只 需要 在 请 求 时 在 /env 后 加 上 属性 名 即 可 。 举 例 来 说 ， 
对 阅读 列表 应 用 程序 发 起 /env/amazon.associate_idq 请 求 ， 获 得 的 结果 是 habuma-20 ( Al x: 
本 形式 )。 

回想 第 3 章 ， 这 些 环境 属性 可 以 通过 econf igurationPropert ies 注 解 很 方便 地 使 用 。 这 
些 环 境 属 性 会 注入 带 有 QConfigurationProperties 注 解 的 Bean 的 实例 属性 。/configprops 端 点 
会 生成 一 个 报告 ， 说 明 如 何 进行 设置 (注入 或 其 他 方式 )。 代 码 清单 7-4 是 阅读 列表 应 用 程序 的 配 
置 属性 报告 片段 。 
代码 清单 7-4 配置 属性 报告 

{ 

"amazonProperties": { 
"prefix": "amazon", Amazon 配 置 


"properties": { 


























ni 
















































































"associateId": "habuma-20" 
} 
} 
"ServerProperties": ( «L— —À 
"prefix": "server", | 服务 器 配置 
"properties": { 


"address": null, 
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"contextPath": null, 
"port"; null, 
"servletPath": "/", 
"sessionTimeout": null, 
"ssl": null, 

"tomcat": { 


"accessLogEnabled": false, 
"accessLogPattern": null, 
"backgroundProcessorDelay": 





"basedir": null, 


"compressableMimeTypes": 


"compression": "off", 


"maxHttpHeaderSize": O0, 


"maxThreads": O0, 
"portHeader": null, 


"protocolHeader": null, 
"remoteIpHeader": null, 


"uriEncoding": null 


} 





"text/html,text/xml,text/plain", 


片段 中 的 第 一 个 内 容 是 我 们 在 第 3 章 里 创建 的 amazonProperties Bean。 报告 显示 它 添加 了 


econfigurationProperties 注 解 ， 








前 级 为 amazon。associateId 








是 因为 在 application.yml 里 ， 我 们 把 amazon .associateId 























属性 设置 为 habuma-20。 这 
属性 设置 成 了 habuma-20。 








ni 


你 还 会 看 到 一 个 serverProperties 条 目 ( 前 级 是 server ), 还 有 一 些 属性 。 它 们 都 有 默认 





值 ， 你 也 可 以 通过 设置 server 前 缀 的 
server .port 属 性 来 修改 服务 咒 监 听 的 端口 。 

属性 如 何 设置 , 这 个 报告 也 能 作为 一 个 快速 参考 指南 ,告诉 
E 么 设置 般 入 式 Tomcat 服 务 右 的 最 大 线程 数 ， 可 以 
看 一 下 配置 属性 报告 ， 里 面 会 有 一 条 server .tomcat .maxThreads， 这 就 是 你 要 找 的 属性 。 











除了 展现 运行 中 应 用 程序 的 配置 








你 有 哪些 属性 可 以 设置 。 例如， 如 有 果 你 不 














4. 生成 端点 到 控制 器 的 映射 








在 应 用 程序 相对 较 小 的 时 候 , 很 容易 搞 清 楚 控 人 





属性 来 改变 这 些 值 。 举 例 来 说 ， 你 可 以 通过 设置 



































三 


剖 器 都 映射 到 了 哪些 端点 上 。 如 果 Web 界 面 的 


控制 器 和 请 求 处 理 方法 数量 多 ， 那 最 好 能 有 一 个 列表 ， 罗 列 出 应 用 程序 发 布 的 全 部 端点 。 
/mappings 端 点 就 提供 了 这 么 一 个 列表 。 代 码 清单 7-5 是 阅读 列表 应 用 程序 的 映射 报告 片段 。 

















代码 清单 7-5 ”阅读 列表 应 用 程序 的 控制 器 /端点 映射 


( 


ReadingListController 


"([/],methods-[GET],params-[],headers-[],consumes-[],produces-[], q—4 


"bean": "requestMappingHandlerMapping", 


custom-[]J": ( 


"method": "public java.lang.String readinglist.ReadingListController. 
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readersBooks (readinglist.Reader,org.springframework.ui.Model)" 


} ， 





"([/],methods-[POST],params-[],headers-[],consumes-[],produces-[], 
custom-[])": ( 
"bean": "requestMappingHandlerMapping", 
"method": "public java.lang.String readinglist.ReadingListController 
.addToReadingList (readinglist.Reader,readinglist. 
Book)" 
} 
"([/autoconfig],methods-[GET],params-[],headers-[],consumes-[] a 
,produces=[],custom=[]}": { 
"bean": "endpointHandlerMapping", 
"method": "public java.lang.Object org.springframework.boot 
.actuate.endpoint.mvc.EndpointMvcAdapter.invoke()" 
n 自动 配置 报告 
的 映射 


) 


这 里 我 们 可 以 看 到 不 少 端点 的 映射 。 每 个 映射 的 键 都 是 一 个 字符 串 , 其 内 容 就 是 Spring MVC 
的 eReauestMapping 注 解 上 设置 的 属性 。 实 际 上 ， 这 个 字符 哩 能 让 你 清晰 地 了 解 控制 器 是 如 何 
映射 的 , 哪怕 不 看 源 代码 。 每 个 映射 的 值 都 有 两 个 属性 : bean 和 method。 bean 属 性 标识 了 Spring 
Bean 的 名 字 ， 映 射 源 自 这 个 Bean。method 属 性 是 映射 对 应 方法 的 全 限定 方法 签名 。 

头 两 个 映射 关乎 应 用 程序 中 ReadingListController 的 请 求 如 何 处 理 。 第 一 个 表明 
readersBooks () 方 法 处 理 根 路 径 (/) 的 HITP GET 请 求 。 第 二 个 表明 PosT 请 求 映 射 到 
addToReadingList () 方 法 上 。 

接 下 来 的 映射 是 Actuator 提 供 的 端点 。/autoconfig 端 点 的 HITP GT 请求 由 Spring Boot 的 
EndpointMvcAdapterZÉff invoke() 方法 来 处 理 。 当然 ; 还 有 很 多 其 他 Actuator 的 端点 没有 列 
在 代码 清单 7-5 里 ， 这 种 省 略 完全 是 为 了 简化 代码 示例 。 

Actuator 的 配置 端点 能 很 方便 地 让 你 了 解 应 用 程序 是 如 何 配置 的 。 能 看 到 应 用 程序 在 运行 时 
究竟 发 生 了 什么 ， 这 很 有 趣 、 很 实用 。 度 量 端点 能 展示 应 用 程序 运行 时 内 部 状况 的 快照 。 







































































7.4.2 ”运行 时 度量 


你 到 医生 那里 体检 时 ,会 做 一 系列 检查 来 了 解 身 体 状 况 。 有 一 些 重要 的 项 目 永远 不 会 变 ， 比 
如 血型 。 这 类 测试 能 让 医生 了 解 你 身体 的 一 贯 情况 。 其 他 测试 让 医生 掌握 你 接受 检查 时 的 身体 状 
况 。 你 的 心律 、 血 压 和 胆固醇 水 平 有 助 于 医生 评估 你 的 健康 。 这 些 指标 都 是 临时 的 ， 很 可 能 随时 
间 发 生变 化 ， 但 它们 同样 是 很 有 帮助 的 运行 时 指标 。 

与 之 类 似 , 对 运行 时 度量 情况 做 一 个 快照 , 这 对 评估 应 用 程序 的 健康 情况 很 有 帮助 。Actuator 
提供 了 一 系列 端点 , 让 你 能 在 运行 时 快速 检查 应 用 程序 。 让 我 们 来 了 解 一 下 这 些 端点 , 从 /metrics 
开始 。 

1. 查看 应 用 程序 的 度量 值 

关于 运行 中 的 应 用 程序 ， 有 很 多 有 趣 而 且 有 用 的 信息 。 举 个 例子 ， 了 解 应 用 程序 的 内 存 情况 
(可 用 或 空闲 ) 有 助 于 决定 给 JVM 分 配 多 少 内 存 。 对 Web 应 用 程序 而 言 , 不 用 查看 Web 服 务 器 日 志 ， 
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如 果 请 求 失 败 或 者 是 耗 时 太 长 ， 就 可 以 大 概 知道 内 存 的 情况 了 。 
运行 中 的 应 用 程序 有 诸多 计数 器 和 度量 器 ，/metrics 端 点 提供 了 
7-6 是 /metrics 端 点 输出 内 容 的 示例 。 


代码 清单 7-6 /metrics 端 点 提供 了 很 多 有 用 的 运行 时 数据 


{ 
mem: 198144, 
mem.free: 144029, 
processors: 8, 
uptime: 1887794, 
instance.uptime: 1871237, 
Ssystemload.average: 1.33251953125, 
heap.committed: 198144, 
heap.init: 131072, 
heap.used: 54114, 
heap: 1864192, 
threads.peak: 21, 
threads.daemon: 19, 
threads: 21, 
classes: 9749, 
classes.loaded: 9749, 
classes.unloaded: 0, 
gc.ps, scavenge.count: 22, 








些 东 西 的 快照 。 代 码 清 单 


gc.ps scavenge.time: 


gc.ps marksweep.count: 
gc.ps marksweep.time: 
httpsessions.max: -1, 


httpsessions.active: 


122: 
2, 
156, 


1, 


datasource.primary.active: 0, 
datasource.primary.usage: O0, 
counter.status.200.beans: 1, 


counter. 
counter. 
counter. 


counter. 
counter. 
counter. 











status.200.env: 1, 
status.200.1ogin: 3, 
status.200.metrics: 2, 

counter.status.200.root: 6, 
status.200.star-star: 9, 
status.302.1ogin: 3, 
Status.302.1ogout: 1, 


counter.status.302.root: 5, 


gauge.response.beans: 
165; 


gauge.reSponse.env: 


gauge.response.login: 
gauge.response.logout: 


169, 


3, 
0 


à 
gauge.response.metrics: 2, 


gauge.response.root: 


11, 


gauge.response.star-star: 2 


} 


/metrics 端 点 提供 了 很 多 信息 ， 逐 行 查看 这 些 度量 值 太 麻烦 。 


息 的 类 型 对 它们 做 了 个 分 类 


表 7-2 根 据 所 提供 信 
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表 7-2 /metrics 端 点 报告 的 度量 值 和 计数 器 











分 类 前 组 报告 内 容 
垃圾 收集 器 ”9c.* 已 经 发 生 过 的 垃圾 收集 次 数 , 以 及 垃圾 收集 所 耗费 的 时 间 , 适用 于 标记 -清理 














外 圾 收集 器 和 并 行 垃圾 收集 器 (数据 源 自 java.lang.management. 


GarbageCollectorMXBean) 



















































































内 存 mem. * 分 配给 应 用 程序 的 内 存 数 量 和 空闲 的 内 存 数 量 (数据 源 自 java.1lang . 
Runtime) 
WE heap.* 当前 内 存 用 量 (数据 源 自 java. lang.management . MemoryUsage) 
类 加 载 器 classes.* JVM 类 加 载 器 加 载 与 卸载 的 类 的 数量 (数据 源 自 java.1lang. management. 
ClassLoadingMXBean) 
系统 processors, uptime ”系统 信息 , 例如 处 理 器 数量 (数据 源 自 java.1lang .Runtime), 运行 时 间 ( 数 
instance.uptime, 据 源 自 java.lang.management .RuntimeMXBean)、 平 均 负 载 CHE 
systemload.average java.lang.management .OperatingSystemMXBean) 
线程 池 threads.* 线程 、 守 护 线程 的 数量 ， 以 及 JVM 启 动 后 的 线程 数量 峰值 CHOR UR E 
java.lang .management.ThreadMXBean) 
数据 源 datasource.* 数据 源 连接 的 数量 〈 源 自 数据 源 的 元 数据 ， 仅 当 Spring 应 用 程序 上 下 文 里 存 
{DataSource Bean 的 时 候 才 会 有 这 个 信息 ) 
Tomcat 会 话 httpsessions.* Tomcat 的 活跃 会 话 数 和 最 大 会 话 数 (数据 源 自 租 入 式 Tomcat 的 Bean, 仅 在 使 
用 檬 入 式 Tomcat 服 务 器 运行 应 用 程序 时 才 有 这 个 信息 ) 
HTTP counter.status.*, 多 种 应 用 程序 服务 HITP 请 求 的 度量 值 与 计数 器 


gauge.response.* 


请 注意 ,这 里 的 一 些 度量 值 ， 比 如 数据 源 和 Tomcat 会 话 , 仅 在 应 用 程序 中 运行 特定 组 件 时 才 
有 数据 。 你 还 可 以 注册 自己 的 度量 信息 ，7.4.3 节 里 会 提 到 这 一 点 。 

HTTP 的 计数 器 和 度量 值 需 要 做 一 点 说 明 。counter.status 后 的 值 是 HTTP 状 态 码 ， 随 后 是 所 请 
求 的 路 径 。 举 个 例子 ，counter .status.200.metrics 表 明 /metrics 端 点 返回 200 (OK ) 状态 码 
的 次 数 。 

HTTP 的 度量 信息 在 结构 上 也 差不多 , 却 在 报告 另 一 类 信息 。 它 们 全 部 以 gauge.response 开 头 ， 

表明 这 是 HTTP 响 应 的 度量 信息 。 前 缀 后 是 对 应 的 路 径 。 度 量 值 是 以 毫秒 为 单位 的 时 间 ， 反 映 了 
最 近 处 理 该 路 径 请 求 的 耗 时 。 举 个 例子 ， 代 码 清单 7-6 里 的 gauge.response.beans 说 明 上 一 次 
请 求 耗 时 169 毫 秒 。 
这 里 还 有 几 个 特殊 的 值 需要 注意 。root 路 径 指向 的 是 根 路 径 或 /。star-star 代 表 了 那些 Spring 
认为 是 静态 资源 的 路 径 , 包括 图 片 、JavaScript 和 样式 表 ,， 其 中 还 包含 了 那些 找 不 到 的 资源 。 这 就 
是 为 什么 你 经 常会 看 到 counter.status.404.star-star， 这 是 返回 了 HTTP 404 (NOT 
FOUND) 状态 的 请 求 数 。 

/metrics 端 点 会 返回 所 有 的 可 用 度量 值 ， 但 你 也 可 能 只 对 某 个 值 感 兴趣 。 要 获取 单个 值 ， 请 
求 时 可 以 在 URL 后 加 上 对 应 的 键 名 。 例 如 ， 要 查看 空闲 内 存 大 小 ， 可 以 向 /metricsAmem.free 发 一 
个 GET 请 求 : 


$ curl localhost:8080/metrics/mem.free 
144029 


要 知道 ， 虽 然 响应 里 的 content-Type 头 设置 为 application/json;charset=UTF-8 ， 但 实际 
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/metrics/{name} 的 结果 是 文本 格式 的 。 因 此 ， 如 果 需 要 的 话 ， 你 也 可 以 把 它 视 为 JSON 来 处 理 。 

2. 追踪 Web 请 求 

尽管 /metrics 端 点 提供 了 一 些 针 对 Web 请 求 的 基本 计数 器 和 计时 器 , 但 那些 度量 值 缺少 详细 信 
息 。 知 道 所 处 理 请 求 的 更 多 信息 是 很 有 帮助 的 ， 尤 其 是 在 调试 时 ， 所 以 就 有 了 /trace 这 个 端点 。 

/trace 端 点 能 报告 所 有 Web 请 求 的 详细 信息 , 包括 请 求 方法 、 路 径 、 时 间 截 以 及 请 求 和 响应 的 
头 信息 。 代 码 清单 7-7 是 /trace 输 出 的 一 个 片段 ， 其 中 包含 了 整个 请 求 跟踪 项 。 


代码 清单 7-7 /trace 端 点 会 记录 下 Web 请 求 的 细节 
[ 











"timestamp": 1426378239775, 
"imto*'s i 
"method": "GET", 
"path": "/metrics", 
"headers": { 
"request": ( 
"accept ys 
"host": "localhost:8080", 
"user-agent": "curl/7.37.1" 
), 
"response": ( 
"X-Content-Type-Options": "nosniff", 
"X-XSS-Protection": "1; mode=block", 


"Cache-Control": 
"no-cache, no-store, max-age-0, must-revalidate", 


"Pragma": "no-cache", 

"Expires": "0", 

"X-Frame-Options": "DENY", 
"X-Application-Context": "application", 
"Content-Type": "application/json;charset-UTF-8", 
"Transfer-Encoding": "chunked", 

"Date": "Sun, 15 Mar 2015 00:10:39 GMT", 
"status"; "200" 








正如 methoda 和 path 属 性 所 示 ， 你 可 以 看 到 这 个 跟踪 项 是 一 个 针对 /mmetrics 的 请 求 。 
timestamp 属 性 (以 及 响应 中 的 pate 头 ) 告诉 了 你 请 求 的 处 理 时 间 。headqers 属 性 的 内 容 是 请 
求 和 响应 中 所 携带 的 头 信息 。 
虽然 代码 清单 7-7 里 只 显示 了 一 条 跟踪 项 , 但 /trace 端 点 实际 能 显示 最 近 100 个 请 求 的 信息 , 包 
含 对 /trace 自 己 的 请 求 。 它 在 内 存 里 维护 了 一 个 跟踪 库 。 稍 后 在 7.4.4 节 里 ， 你 会 看 到 如 何 创建 一 
个 自 定义 的 跟踪 库 实现 ， 以 便 将 请 求 的 跟踪 持久 化 。 

3. 导出 线程 活动 

在 确认 应 用 程序 运行 情况 时 ， 除 了 跟踪 请 求 ， 了 解 线程 活动 也 会 很 有 帮助 。/dump 端 点 会 生 
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成 当前 线程 活动 的 快照 。 

完整 的 线程 导出 报告 里 会 包含 应 用 程序 的 每 个 线程 。 为 了 节省 空间 ， 代 码 清单 7-8 里 只 放 了 
一 个 线程 的 内 容 片段 。 如 你 所 见 , 其 中 包含 很 多 线程 的 特定 信息 , 还 有 线程 相关 的 阻塞 和 锁 状 态 。 
本 例 中 ， 还 有 一 个 跟踪 栈 (stack trace )， 表 明 这 是 一 个 Tomcat 容 絮 线 程 。 


代码 清单 7-8 /dump 端 点 提供 了 应 用 程序 线程 的 快照 
[ 








"threadName": "container-0", 
"threadIid": 19, 
"plockedTime": -1, 
"blockedCount": 0, 
"waitedTime": -1, 


"waitedCount": 64, 

"lockName": null, 
"lockOwnerId": -1, 
"LlockOwnerName": null, 
"inNative": false, 

"suspended": false, 
"threadState": "TIMED WAITING", 
"stackTrace": [ 


( 





"className": "java.lang.Thread", 
"fileName": "Thread.java", 
"lineNumber": -2, 

"methodName": "sleep", 


"nativeMethod": true 


"className": "org.springframework.boot.context.embedded. 
tomcat.TomcatEmbeddedServletContainer$1", 

"fileName": "TomcatEmbeddedServletContainer.java", 

"lineNumber": 139, 

"methodName": "run", 


"nativeMethod": false 
} 
J; 
"lockedMonitors": [], 
"lockedSynchronizers": [], 
"lockInfo": null 





4. 监控 应 用 程序 健康 情况 
如 果 你 想 知道 自己 的 应 用 程序 是 否 在 运行 ， 可 以 直接 访问 /health 端点 。 在 最 简单 的 情况 下 ， 


该 端点 会 显示 一 个 简单 的 SON， 内 容 如 下 : 


("status":"UP"] 
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status 属 性 显示 了 应 用 程序 在 运行 中 。 当 然 ， 它 的 确 在 运行 ， 此 处 的 响应 无 关 紧 要 ， 任 何 
输出 都 说 明 这 个 应 用 程序 在 运行 。 但 /health 端 点 可 以 输出 的 信息 远 远 不 止 简单 的 UP 状态 。 

/health 端 点 输出 的 某 些 信息 可 能 涉及 内 容 ， 因 此 对 未 经 授权 的 请 求 只 能 提供 简单 的 健康 状 
态 。 如 果 经 过 身份 验证 ( 比如 你 已 经 登录 了 )， 则 可 以 提供 更 多 信息 。 EE A 
一 些 健康 信 ， 息 的 示例 : 


{ 
"status" :TU 
"diskSpace": ( 
"status :"UP", 
"free":377423302656, 
"threshold":10485760 




















ja 
"db":( 
"Status":"UP", 
"database":"H2", 
"hello"':1 
j 
} 


除了 基本 的 健康 状态 ， 可 用 的 磁盘 空间 以 及 应 用 程序 正在 使 用 的 数据 库 状态 也 可 以 看 到 。 
health 端 点 所 提供 的 所 有 信息 都 是 由 一 个 或 多 个 健康 指示 顺 提 供 的 。 表 7-3 列 出 了 Spring Boot 
自 带 的 健康 指示 需 。 





























表 7-3 Spring Boot 自 带 的 健康 指示 器 






































健康 指示 器 键 报告 内 容 

ApplicationHealthIndicator none 永远 为 UP 

DataSourceHealthIndicator db 如 果 数 据 库 能 连 上 ， 则 内 容 是 UP 和 数据 库 类 型 ， 否 则 为 DOWN 

DiskSpaceHealthindicator diskspace ， 如果 可 用 空间 大 于 阔 值 ， 则 内 容 为 Up 和 可 用 磁盘 空间 ， 如 果 空 间 
不 足 则 为 DowN 

JmsHealthIndicator jms 如 果 能 连 上 消息 代理 ， 则 内 容 为 Up 和 JMS 提 供 方 的 名 称 ， 否 则 为 
DOWN 

MailHealthIndicator mail 如 果 能 连 上 邮件 服务 器 ， 则 内 容 为 0P 和 邮件 服务 器 主机 和 庙 
否则 为 DOWN 

MongoHealthIndicator mongo 如 果 能 连 上 MongoDB 服 务 器 ， 则 内 容 为 UB 和 MongoDB 服 务 器 版 
本 ; 否则 为 DOWN 

RabbitHealthIndicator rabbit 如 果 能 连 上 RabbitMQ 服 务 器 ， 则 内 容 为 UP 和 版 本 号 ; 否则 为 DOWN 

RedisHealthIndicator redis 如 果 能 连 上 服务 器 ， 则 内 容 为 UP 和 Redis 服 务 器 版 本 ; 否则 为 DowN 

SolrHealthIndicator solr 如 果 能 连 上 Solr 服 务 器 ， 则 内 容 为 UP;， 否则 为 DOWN 











这 些 健康 指示 器 会 按 需 自动 配置 。 举 例 来 说 ， 如 果 Classpath 里 有 javax.sqal.DataSource， 
则 会 自动 配置 DataSsourceHealthIndicator 。 ApplicationHealthIndicator FI Disk- 
R vci 
除了 这 些 自 带 的 健康 指示 器 ， 你 还 会 在 7.4.5 节 里 看 到 如 何 创 建 自 定义 健康 指示 器 。 
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7.1.3 ”关闭 应 用 程序 


假设 你 要 关闭 运行 中 的 应 用 程序 。 比 方 说 ,在 微服 务 架 构 中 , 你 有 多 个 微服 务 应 用 的 实例 运 
行 在 云 上 , 其 中 某 个 实例 有 问题 了 , 你 决定 关闭 该 实例 并 让 云 服务 提供 商 为 你 重启 这 个 有 问题 的 
应 用 程序 。 在 这 个 场景 中 ，Actuator 的 /shutdown 端 点 就 很 有 用 了 。 

为 了 关闭 应 用 程序 ， 你 要 往 /shutdown 发 送 一 个 PosT 请 求 。 例 如 ， 可 以 用 命令 行 工 具 cur1 来 
关闭 应 用 程序 : 

$ curl -X POST http://localhost:8080/shutdown 

很 显然 ,关闭 运行 中 的 应 用 程序 是 件 危险 的 事情 ,因此 这 个 端点 默认 是 关闭 的 。 如 果 没 有 显 
式 地 开启 这 个 功能 ， 那 么 PosT 请 求 的 结果 是 这 样 的 : 

("message":"This endpoint is disabled") 

要 开启 该 端点 5 可 以 将 snaqpoints .shutdown .enabled 设 置 为 true。 举例 来 说 ， 可 以 把 如 
下 内 容 加 入 application.yml， 借 此 开启 /shutdown 端 点 : 


endpoints: 
shutdown: 
enabled: true 


打开 /shutdown 端 点 后 ， 你 要 确保 并 非 任 何人 都 能 关闭 应 用 程序 。 这 时 应 该 保护 /shutdown 端 
点 ， 只 有 经 过 授权 的 用 户 能 关闭 应 用 程序 。 在 7.5$ 节 里 你 将 看 到 如 何 保护 Actuator 端 点 。 


7.1.4 获取 应 用 信息 


Spring Boot Actuator 还 有 一 个 有 用 的 端点 。/info 端 点 能 展示 各 种 你 希望 发 布 的 应 用 信息 。 针 
对 该 端点 的 GET 请 求 的 默认 响应 是 这 样 的 : 

o 

很 显然 ， 一 个 空 的 JSON 对 象 没 什么 用 。 但 你 可 以 通过 配置 带 有 info 前 绥 的 属性 向 /info 端 点 
的 响应 添加 内 容 。 例 如 ， 你 希望 在 啊 应 中 添加 联系 邮箱 。 可 以 在 application.yml 里 设置 名 为 


info.contactEmail 的 属性 : 






























































info: 
contactEmail: support@myreadinglist.com 


现在 再 访问 /info 端 点 ， 就 能 得 到 如 下 响应 : 
{ 


"contactEmail":"support@myreadinglist.com" 


} 
这 里 的 属性 也 可 以 是 般 套 的 。 例 如 ， 假 设 你 希望 提供 联系 邮箱 和 电话 。 在 application.yml 里 
可 以 配置 如 下 属性 : 
info: 
contact: 


email: supportümyreadinglist.com 
phone: 1-888-555-1971 





























122 第 7 章 深入 Actuator 





/info 端 点 返回 的 JSON 会 包含 一 个 contact 属 性 ， 其 中 有 email 和 phone 属 性 : 


， > 一、 














{ 

"contact "st{ 
"email":"support@myreadinglist.com", 
"phone":"1-888-555-1971" 

} 

j 


向 /info 端 点 添加 属性 只 是 定制 Actuator 行 为 的 众多 方式 之 一 。 稍 后 在 7.4 节 里 ， 我 们 还 会 看 到 
其 他 配置 与 扩展 Actuator 的 方式 。 但 现在 ， 先 让 我 们 来 看 看 如 何 保护 Actuator 的 端点 。 














7.2 连接 Actuator 的 远程 shell 




















Actuator 通 过 REST 端 点 提供 了 不 少 非常 有 用 的 信息 。 男 一 个 深入 运行 中 应 用 程序 内 部 的 方式 
是 使 用 远程 shell。Spring Boot 集 成 了 CRaSH， 一 种 能 能 入 任意 Java 应 用 程序 的 shell。Spring Boot 
还 扩展 了 CRaSH， 添 加 了 不 少 Spring Boot 特 有 的 命令 ， 提 供 了 与 Actuator 端 点 类 似 的 功能 。 

要 使 用 远程 shell， 只 需 加 入 远程 shell 的 起 步 依赖 即 可 。 你 需要 这 样 的 Gradle 依 赖 : 

compile("org.springframework.boot:spring-boot-starter-remote-shell") 

如 果 用 Maven 构 建 项 目 ， 你 需要 在 pom.xml 文 件 里 添加 如 下 依赖 : 


<dependency> 
«groupId»org.springframework.boot«/groupId» 


«artifactlId»spring-boot-starter-remote-shell«/artifactlid» 
</dependency> 


如 果 要 用 Spring Boot CLI 来 运行 你 所 开发 的 应 用 程序 ， 则 需要 如 下 ecrab 注 解 : 

GGrab("spring-boot-starter-remote-shell") 

添加 了 远程 shell 依 赖 后 ， 就 可 以 构建 并 运行 应 用 程序 了 。 在 启动 的 时 候 ， 可 以 看 到 要 写 进 日 
志 的 一 行 密码 。 这 行 密码 所 在 的 行 大 概 是 这 样 的 : 

Using default security password: efe30c70-5bf0-43b1-9d50-c7a02dda74d79 

与 这 个 密码 搭配 使 用 的 用 户 名 是 user。 密 码 本 身 是 随机 生成 的 ， 每 次 运行 应 用 程序 时 都 会 有 
所 变化 。 

现在 你 可 以 通过 SSH 工 具 连 接 shell 了 ， 它 监听 的 端口 号 是 2000。 如 果 你 用 的 是 Unix 的 ssh 命 
S, 那么 它 看 起 来 大 概 是 这 样 的 : 


~% ssh user@localhost -p 2000 
Password authentication 













































































Password: 
/NN / C2 by 
C C)N | | RUR er |] NNNN 
NM ll: skr b EI (3 Ero 9 i) 
' | | ILLE PLI dS | 
Hee/ 
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:: Spring Boot :: (v1.3.0.RELEASE) on habuma.local 
25 


KIRT! 你 已 经 连 上 shell 了 。 现 在 应 该 做 什么 ? 
远程 shell 提 供 了 24 个 可 以 在 运行 应 用 程序 上 下 文中 执行 的 命令 , 其 中 大 部 分 都 是 CRaSH 自 带 
。 但 Spring Boot 也 添加 了 一 些 。 表 7-4 列 出 了 这 些 Spring Boot 特 有 的 命令 。 


表 7-4 Spring Boot 提 供 的 CRaSH shell 命 令 
命 4 Ho Ë 


E autoconfi 生成 自动 配置 说 明报 告 ， 和 /autoconfig 端 点 输出 的 内 容 类 似 ， 只 是 把 JSON 换 成 了 纯 文本 


beans 列 出 Spring 应 用 程序 上 下 文 里 的 Bean， 与 /beans 端 点 输出 的 内 容 类 似 
endpoint 调用 Actuator 端 点 


metrics 显示 Spring Boot 的 度量 信息 ， 与 /metrics 端 点 类 似 ， 但 显示 的 是 实时 更 新 的 数据 
让 我 们 看 看 如 何 使 用 这 些 Spring Boot 添 加 的 shell 命 









































7.2.1 查看 autoconfig 报告 


autoconfig 命 令 生 成 了 一 个 与 Actuatord 的 /autoconfig 端点 类 似 的 报告 。 图 7-1 
autoconfig 命 令 输 出 的 内 容 和 截取 。 


eoe Terminal 一 ssh 一 140x40 
ssh 


» autoconfig 
Endpoint: autoConfigurationAuditEndpoint 


Positive Matchi 


AuditAutoConfigurationfauthenticationAuditListener: 

OnClassCondition: GConditionalünClass classes found: org.springframework.security.authentication.event.AbstractAuthenticationEvent 
AuditAutoConfigurationfauthorizationAuditListener: 

OnClassCondition: QConditionalnClass classes found: org.springframework.security.access.event.AbstractAuthorizationEvent 
AuditAutoConfiguration.AuditEventRepositoryConfiguration: 

OnBeanCondition: eConditionalOnMissingBean (types: org.springframework.boot.actuate.audit.AuditEventRepository; SearchStrategy: all) found 
no beans 
CrshAutoConfiguratio 

OnClassCondition: eConditionalonClass classes found: org.crsh.plugin.PluginLifeCycle 
CrshAutoConfigurationfshellBootstrap: 

OnBeanCondition: GConditionalünMissingBean (types: org.crsh.plugin.PluginLifeCycle; SearchStrategy: all) found no beans 
CrshAutoConfiguration.AuthenticationManagerAdapterAutoConfiguration: 

OnPropertyCondition: matched 

OnBeanCondition: GConditionalOnBean (types: org.springframework.security.authentication.AuthenticationManager; SearchStrategy: all) found 
the following [authenticationManager] 
CrshAutoConfiguration。 bud r e e e a A pee EH 

OnBeanCondition: GConditionalOnMissingBean boot.actuate.autoconfigure.ShellProperties$CrshShellAuthenticationP 


WebSocketAutoConfiguratio ToncatWebSocketConfigurationévebsoc 


OnBeanCondition: QconditionalOnMissingBean (names: websocketContainarCustomizer; Search?trategy: all) found no beans 


Negative Matches 


CrshAutoConfigurationfjaasAuthenticationPropertie: 

OnPropertyCondition: GConditionalünProperty missing required properties shell.auth 
CrshAutoConfigurationfkeyAuthenticationProperties 

OnPropertyCondition: &ConditionalünProperty missing required properties shell.auth 
CrshAutoConfigurationfsimpleAuthenticationProperties: 

OnPropertyCondition: matched 

OnBeanCondition: @ConditionalOnMissingBean (types: org.springframework.boot.actuate.autoconfigure.ShellProperties$CrshShellAuthenti. 
roperties; SearchStrategy: all) found the following [springAuthenticationProperties] 
EndpointMBeanExportAutoConfigurationfmbeanServer: 

OnBeanCondition: gConditionalünMissingBean (types: javax.management.MBeanServer; SearchStrategy: all) found the following [mbeanServer] 
HealthIndicatorAutoConfiguration&applicationHealthIndicator: 

OnBeanCondition: @ConditionalOnMissingBean (types: org.springframework.boot.actuate.health.HealthIndicator; SearchStrategy: all) found the 
following [diskSpaceHealthIndicator, dbHealthIndicator] 
HealthIndicatorAutoConfiguration.MongoHealthIndicatorConfiguration: 

OnPropertyCondition: matched 

OnBeanCondition: @ConditionalOnBean (types: org.springframework.data.mongodb.core.MongoTemplate; SearchStrategy: all) found no beans 
HealthIndicatorAutoConfiguration.RabbitHealthIndicatorConfiguration: 

OnPropertyCondition: matched 

OnBeanCondition: QGConditionalünBean (types: org.springframework.amqp.rabbit.core.RabbitTemplate; SearchStrategy: all) found no beans 
HealthIndicatorAutoConfiguration.RedisHealthIndicatorConfiguration: 

OnPropertyConditioi matched 

OnBeanCondition: GConditionalOnBean (types: org.springframework.data.redis.connection.RedisConnectionFactory; SearchStrategy: all) found n 








图 7-1 ”autoconfig 命 令 的 输出 





124 第 7 章 深入 Actuator 





如 你 所 见 ， 结果 分 为 两 组 一 一 匹配 和 不 匹配 ， 和 /autoconfig 端 点 的 结果 一 样 。 实 际 上 ， 唯 一 
的 显著 区 别 在 于 ，autoconfig 命 令 输出 的 是 文本 ， 而 /autoconfig 端 点 输出 的 是 JSON， 其 他 都 
一 样 。 

我 不 打算 去 讲 CRaSH 自 己 提供 的 shell 命 令 , 但 你 可 能 想 把 autoconfig 命 令 的 输出 和 CRaSH 
的 less 命 令 用 管道 串 起 来 : 


> autoconfig | less 


less 命 令 和 Unix shell 里 的 同名 命令 很 相似 , 能 让 你 穿梭 于 文件 中 。autoconfig 的 输出 很 长 ， 
但 less 命 令 会 让 它 更 容易 读 取 和 查阅 。 


7.2.2 ” 列 出 应 用 程序 的 Bean 


autoconfig shell 命 令 的 输出 和 /autoconfig 端 点 的 输出 类 似 ， 但 也 有 不 同 。 对 比 之 下 ， 你 会 
发 现 peans 命 令 的 输出 和 /beans 端 点 的 输出 一 样 。 截 屏 如 图 7-2 所 示 。 


eoe Terminal 一 ssh — 140x30. - 
ssh | 十 






































> beans 

[£context-application, parent-null, beans-[ibean-application, scope-singleton, type-demo.Application$$EnhancerBySpringCGLIB$$1671b5b9, resou 
rce-null, dependencies-[]), íbean-amazonConfig, scope-singleton, type-demo.AmazonConfig, resource-URL [jar:file:/Users/habuma/Projects/BookP 
rojects/walls6/code/ch03/build/libs/demo-0.0.1-SNAPSHOT.jar!/demo/AmazonConfig.class], dependencies-[]), (beanscustomErrorAttributes, scope- 
singleton, type-demo.CustomErrorAttributes, resource-URL [jar:file:/Users/habuma/Projects/BookProjects/walls6/code/ch03/build/libs/demo-0.0. 
1-SNAPSHOT.jar!/demo/CustomErrorAttributes.class], dependencies-[]), (bean-readerHandlerMethodArgumentResolver, scope-singleton, type-demo.R 
eaderHandlerMethodArgumentResolver, resource-URL [jar:file:/Users/habuma/Projects/BookProjects/walls6/code/ch03/build/libs/demo-0.0.1-SNAPSH 
OT. jar!/demo/ReaderHandlerMethodArgumentResolver.class], dependencies-[]), (bean-readingListController, scope-singleton, type-demo.Readingli 
stController, resource-URL [jar:file:/Users/habuma/Projects/BookProjects/walls6/code/ch03/build/libs/demo-0.0. 1-SNAPSHOT. jar! /demo/ReadingLi 
stController.class], dependencies-[readingListRepository, amazonConfigl), (bean-securityConfig, scope-singleton, type-demo.SecurityConfig$$E 
nhancerBySpringCGLIB$$6c0da241, resource-URL [jar:file:/Users/habuma/Projects/BookProjects/walls6/code/ch03/build/libs/demo-0.0.1-SNAPSHOT. j 
ar!/demo/SecurityConfig.class], dependencies-[mvcContentNegotiationManager, org.springframework.security.config.annotation.authentication.co 
nfiguration.AuthenticationConfiguration, objectPostProcessor, readerRepositoryll, íbean-org.springframework.boot.autoconfigure.PropertyPlace 
holderAutoConfiguration, scope-singleton, type-org.springframework.boot.autoconfigure.PropertyPlaceholderAutoConfiguration$$EnhancerBySpring 
CGLIB$$79642b89, resource-null, dependencies-[]), (bean-org.springframework.boot.autoconfigure.condition.BeanTypeRegistry, scope-singleton, 
type=org. springframework.boot.autoconfigure.condition.BeanTypeRegistry$O0ptimizedBeanTypeRegistry, resource-null, dependencies-[]), (bean-pro 
pertySourcesPlaceholderConfigurer, scope-singleton, typecorg.springframework.context.support.PropertySourcesPlaceholderConfigurer, resource- 
class path resource [org/springframework/boot/autoconfigure/PropertyPlaceholderAutoConfiguration.class], dependencies-[]), (bean-org.springf 
ramework. boot.autoconfigure.websocket.WebSocketAutoConfiguration$TomcatWebSocketConfiguration, scope-singleton, type-org.springframework.boo 
t.autoconfigure.websocket.WebSocketAutoConfiguration$TomcatWebSocketConfiguration$$EnhancerBySpringCGLIB$$cd24b958, resource-null, dependenc 
ies-[]), fbean-websocketContainerCustomizer, scope-singleton, type-org.springframework.boot.autoconfigure.websocket.TomcatWebSocketContainer 
Customizer, resource-class path resource [org/springframework/boot/autoconfigure/websocket/WebSocketAutoConfiguration$TomcatWebSocketConfigu 
ration.class], dependencies-[]), (bean-org.springframework.boot.autoconfigure.websocket.WebSocketAutoConfiguration, scope-singleton, type-or 
g.springframework.boot.autoconfigure.websocket.WebSocketAutoConfiguration$$EnhancerBySpringCGLIB$$4f7ff3a7, resource-null, dependencies-[]), 
{bean=org. springframework.boot.autoconfigure.web.EmbeddedServletContainerAutoConfiguration$EmbeddedTomcat, scope-singleton, type=org. spring 
framework.boot.autoconfigure.web.EmbeddedServletContainerAutoConfiguration$EmbeddedTomcat$$EnhancerBySpringCGLIB$$bef419eb, resource-null, d 
ependencies-[]), (bean-tomcatEmbeddedServletContainerFactory, scope-singleton, type-org.springframework.boot.context.embedded.tomcat.TomcatE 
mbeddedServletContainerFactory, resource-class path resource [org/springframework/boot/autoconfigure/web/EmbeddedServletContainerAutoConfigu 
ration$EmbeddedTomcat.class], dependencies-[]*, íbean-org.springframework.boot.autoconfigure.web.EmbeddedServletContainerAutoConfiguration, 
Scope-singleton, type-org.springframework.boot.autoconfigure.web.EmbeddedServletContainerAutoConfiguration$$EnhancerBySpringCGLIB$$8Cc82d28f, 


图 7-2 ”beans 命 令 的 输出 

和 /beans 端 点 一 样 ，beans 命 令 会 以 JSON 格 式 列 出 Spring 应 用 程序 上 下 文 里 所 有 的 Bean， 包 
括 所 依赖 的 Bean。 
7.2.3 ”查看 应 用 程序 的 度量 信息 


metricsshell 命 令 会 输出 与 Actuator 的 /metrics 端 点 一 样 的 信息 。/metrics 端 点 以 JSON 格 式 输出 
当前 度量 信息 的 快照 ， 而 metrics 命 令 则 会 接管 shell ， 以 实时 仪表 盘 显 示 结 果 。 图 7-3 就 是 
metrics 命令 的 仪表 盘 。 
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eoe Terminal — ssh — 133x28 
seh | 





mem 953856 
mem. free 374282 
processors 8 
instance.uptime 450939 
uptime 458746 
systemload.average 1.6650390625 
heap. committed 953856 
heap.init 131072 
heap.used 579573 
heap 1864192 
threads. peak 

threads. daemon 

threads 

classes 

classes, Loaded 

classes.unloaded 

gc. ps. scavenge. count 

gc.ps_scavenge. time 

gc.ps marksweep.count 

gc.ps marksweep.time 

httpsessions.max 

httpsessions.active 

a 

t 





图 7-3 ”metrics 命 令 的 仪表 盘 


metzics 命 令 的 实时 仪表 盘 很 难 在 书 里 以 静态 图 片 演示 。 但 你 可 以 试 着 想象 一 下 , AE. 3E 
线程 在 不 断 消耗 和 释放 ， 随 着 类 的 加 载 ， 仪 表盘 里 显示 的 数量 也 会 随 之 变化 ， 以 反映 当 前 值 。 
一 旦 看 完了 metrics 命 令 提供 的 度量 信息 ， 按 Ctrl+C 就 能 回 到 shell 了 。 









































7.2.4 调用 Actuator 端点 





你 现在 应 该 已 经 意识 到 了 , 并 非 所 有 的 Actuator 端 点 都 有 对 应 的 shell 命 令 。 这 是 否 意味 着 shell 
不 能 完全 代替 Actuator 端 点 呢 ? 是 否 仍 要 直接 查询 这 些 端点 来 获取 Actuator 提 供 的 内 部 信息 呢 ? 
虽然 shel 没 能 完全 匹配 上 这 些 端点 ， Vas d bio ame snl 

首先 ， 你 要 知道 自己 想 调 用 哪个 端点 。 在 shell 提 示 符 中 键入 endpoint 1ist 就 能 获得 端点 
的 列表 ， 如 图 7-4 所 示 。 请 注意 ， 列 表 中 的 端点 用 的 是 它们 的 Bean 名 称 ， 而 非 URL 路 径 。 


eoo Terminal — ssh — 140x30 " 
ssh EE 

















> endpoint list 
requestMappingEndpoint 
environmentEndpoint 


metricsEndpoint 

traceEndpoint 

dumpEndpoint 
autoConfigurationAuditEndpoint 
configurationPropertiesReportEndpoint 


>I 





图 7-4 ”获得 端点 列表 
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如 果 想 在 shell 里 调用 其 中 某 个 端点 ,你 可 以 使 用 endpoint invoke 命 令 , 传人 不 带 Endpoint 
后 级 的 Bean 名 称 。 举例 来 说 ， 要 调用 健康 检查 端点 ， 可 以 在 shell 提 示 符 里 键入 endpoint invoke 
health， 如 图 7-5 所 示 。 


eoe Terminal — ssh — 140x30 
ssh de 


» endpoint invoke health 
{status=UP, diskSpace-(statuszUP, free-378016223232, threshold-10485760), db-(status-UP, database-H2, helloz1)) 


>E 











图 7-5 ”调用 健康 检查 端点 


请 注意 ， 这 些 端 点 返回 的 信息 都 是 原始 格式 的 ， 即 未 格式 化 过 的 JSON 文 档 。 虽 然 在 shell 里 
调用 Actuator 的 端点 不 错 ， 但 输出 结果 很 难 阅读 。 dns ， 自 带 的 功能 帮 不 上 忙 。 但 如 果 爱 
折腾 ， 你 也 可 以 创建 一 个 日 定义 的 CRaSH shell 命 令 ， 通过 管道 接受 未 格式 化 的 JSON， 然后 美化 
输出 。 你 总 是 可 以 剪 切 黏 贴 snaqpoint 命 令 的 输出 ， 将 其 放 人 你 喜欢 的 工具 进行 阅读 或 格式 化 。 


7.3 通过 JMX 监控 应 用 程序 


除了 REST 端 点 和 远程 shell，Actuator 还 把 它 的 端点 以 MBean 的 方式 发 布 了 出 来 ， 可 以 通过 
JMX 来 查看 和 管理 。 使 用 JMX 是 管理 Spring Boot 应 用 程序 的 一 个 好 方法 ， 如 果 你 已 在 用 JMX 管 理 
应 用 程序 中 的 其 他 MBean， 则 尤其 如 此 。 

Actuator 的 端点 都 发 布 在 org. SPESE DU boot 域 下 。 比 如 , 你 想 要 查看 应 用 程序 的 请 求 映 
射 关 系 ， 那 么 可 以 看 一 下 图 7-6 (通过 JConsole 查 看 请 求 映射 端点 )。 
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eoe 


Java Monitoring & Management Console 





Connection Window Help 








[: Overview, | Memory | Threads | Classes | VM Summary 





x 











> [3JMImplementation 
» B Tomcat 
» [ com.sun.management 
|> B java.lang 
» B java.nio 
» [93 java.util.logging 
v [3 org.springframework.boot 
v E Endpoint 
> (9 autoConfigurationAuditEndpoint 
> (8 beansEndpoint 
> ® configurationPropertiesReportEndpoint. 
» &® dumpEndpoint 
> G3 environmentEndpoint 
> G healthEndpoint 
> G9 infoEndpoint 
> 89 metricsEndpoint 
v 88 requestMappingEndpoint 
了 Attributes 
EndpointClass 
Sensitive. 
» Operations 
Notifications 
> ® shutdownEndpoint 
> 68 traceEndpoint 





Attribute value 








Name 
Data 


| Value 


(/webjars/**- (bean- resourceHandlerMapping), /**-(bean- resourceHandlerMapping), /**/favicon.ico- (bean fa... 








MBeanattributelnfo 








Name 
Attribute: 
Name 
Description 
Readable true 

Writable false 

is false 

Type java.lang.Object 


| Value 


Data 
Invoke the underlying endpoint 














Descriptor 








Name 
Attribute: 
default 
descriptorType 
displayName 
getMethod 
name 


| Value 


attribute 
Data 
getData 
Data 
































如 你 所 见 ， 在 requestMapping] 


framework.boot 域 中 的 





图 7-6 “通过 JConsole 查 看 请 求 映射 端点 





Endpoint 下 可 以 找到 请 求 映射 端点 ， 位 于 org.spring- 
Endpoint 下 。Data 属 性 中 包含 了 该 端点 所 要 输出 的 JSON 内 容 。 


和 其 他 MBean 一 样 ， 端 点 MBean 有 可 供 调 用 的 操作 。 大 部 分 端点 MBean 只 有 访问 操作 ， 返 回 


其 中 的 某 个 属性 


| 里 自 国 


Java Monitoring & Management Console. 


， 但 /shutdown 端 点 提供 了 一 些 有 趣 ( 同时 具有 毁灭 性 ) 的 操作 ， 如 图 7-7 所 示 。 





Connection Window Help 











[ Overview | "mem | Threads | Classes | VM Summary. 














» [3JMimplementation 
» Ml Tomcat 
» [3i com.sun.management 
» [93 java.lang 
» [9 java.nio 
» [3 java.util.logging 
v E org.springframework.boot 

v E Endpoint 

> $8 autoConfigurationAuditEndpoint 

> ® beansEndpoint 
> 39 configuraionPropertiesReportEndpoint 
> & dumpEndpoint 
> ®@ environmentEndpoint 
> @ healthEndpoint 
> 89 infoEndpoint 
> (89 metricsEndpoint 
> ® requestMappingEndpoint 


v 85 shutdownEndpoint 
b Attributes 
了 Operations 


getEndpointClass 
isSensitive. 
b Notifications 
> GP traceEndpoint 








Operation invocation 





java.lang.Object 0 








MBeanOperationinfo 








Name |Value 
Operation: 
Name 
Description 
Impact 
ReturnType 


shutdown 

Shutdown the ApplicationContext 
UNKNOWN 

java.lang.Object 











Descriptor 





Name 
Operation: 
descriptorType 
displayName 
name 

role 


|Value 


operation 
shutdown 
shutdown 
operation 
































如 果 你 想 要 关闭 应 


KI7-7 shutdown 按钮 会 触发 该 端点 





E 





1203 
尔 意 


如 图 7-7 所 示 ， 
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这 个 界面 就 等 你 点 击 shutdown 按 钮 调用 该 端点 。 请 小 心 ， 这 里 没有 “后 悔 药 ”， 也 没有 “你 确定 


mj? ”之 类 的 提示 。 
接 下 来 你 会 看 图 7-8。 





e Operation return value 
4 message-Shutting down, bye... 
二? 





— OK—— 

















图 7-8 ”应 用 程序 立马 关闭 





Hoe UR E RS 








在 那 以 后 ， 你 的 应 用 程序 就 关闭 了 。 应 用 已 经 关闭 ， 自 然 就 没 办 法 发 布 其 他 月 
MBean 操 作 。 你 必须 重启 ， 和 一 开始 的 启动 方式 一 样 。 





mi 


7.4 定制 Actuator 

虽然 Actuator 提 供 了 很 多 运行 中 Spring Boot 应 用 程序 的 内 部 工作 细节 ， 但 难免 和 你 的 需求 有 
所 偏差 。 也 许 你 并 不 需要 它 提 供 的 所 有 功能 ， 想 要 关闭 一 些 也 说 不 定 。 或 者 ， 你 需要 对 Actuator 
稍 作 扩 展 ， 增 加 一 些 自 定义 的 度量 信息 ， 以 满足 你 对 应 用 程序 的 需求 。 

实际 上 ，Actuator 有 多 种 定制 方式 ， 包 括 以 下 五 项 。 
口 重 命名 端点 。 
口 启用 和 禁用 端点 。 
口 自 定义 度量 信息 。 
a 创建 自 定 义 仓库 来 存储 跟踪 数据 。 


口 搬入 自 定义 的 健康 指示 器 。 
接 下 来 ,我 们 会 了 解 如 何 定 制 Actuator， 以 满足 我 们 的 需要 。 先 来 看 一 个 最 简单 的 定制 : E 
































命名 Actuator 端 点 。 


7.4.1 修改 端点 ID 
每 个 Actuator 端 点 都 有 一 个 ID 用 来 决定 端点 的 路 径 , 比方 说 ,beans 端 点 的 默认 ID 就 是 beans。 
如 果 端 点 的 路 径 是 由 ID 决定 的 , 那么 可 以 通过 修改 ID 来 改变 端点 的 路 径 。 你 要 做 的 就 是 设置 









































一 个 属性 ， 属 性 名 是 endpoints.endpoint-id.ig。 
我 们 用 /shutdown 端 点 来 做 个 演示 ， 它 会 响应 发 往 /shutdown 的 PosT 请 求 。 假 设 你 想 让 它 处 理 
发 往 /rkill 的 PosT 请 求 ， 可 以 通过 如 下 YAML 为 /shutdown 赋 予 一 个 新 的 ID ， 也 就 是 新 的 路 径 ; 


























endpoints: 
shutdown: 
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id: kill 
重 命名 端点 、 修 改 其 路 径 的 理由 很 多 。 最 明显 的 理由 就 是 ， 端 点 的 命名 要 和 团队 的 术语 保持 
一 致 。 你 也 可 能 想 重 命名 端点 ， 让 那些 熟悉 默认 名 称 的 人 找 不 到 它 ， 借 此 增加 一 些 安全 感 。 
遗憾 的 是 , 重 命名 端点 并 不 能 真 的 起 到 保护 作用 , 顶 多 是 让 黑客 慢 点 找到 它们 。 我 们 会 在 7.5 
节 看 到 如 何 保护 这 些 Actuator 端 点 。 现 在 先 让 我 们 来 看 看 如 何 禁 用 某 个 〈 或 全 部 ) 不 希望 别人 访 
问 的 端点 。 


7.4.2. ”启用 和 禁用 端点 


虽然 Actuator 的 端点 都 很 用， 但 你 不 一 定 需 要 全 部 这 些 端点 。 默 认 情 况 下 ， 所 有 端点 〈 除 
了 /shutdown ) 都 启用 。 我 们 已 经 看 过 如 何 设置 endpoints.shutdown.enabled 为 true， 以 此 
开启 /shutdown 端 点 〈 详 见 7.1.1 节 )。 用 同样 的 方式 ， 你 可 以 禁用 其 他 的 端点 ， 将 endqpoints . 
endpoint-id.enabled 设 置 为 false。 

例如 ， 要 禁用 /metrics 端 点 ， 你 要 做 的 就 是 将 sndqpoints.metrics.enabledq 属 性 设置 为 
false。 在 application.yml 里 做 如 下 设置 : 





























endpoints: 
metrics: 
enabled: false 


如 果 你 只 想 打开 一 两 个 端点 ， 那 就 先 禁 用 全 部 端点 ， 然 后 启用 那 几 个 你 要 的 ， 这 样 更 方便 。 
例如 ， 考 虑 如 下 application.yml 片 段 : 
endpoints: 
enabled: false 


metrics: 
enabled: true 


正如 以 上 片段 所 示 , endpoints .enabledq 设 置 为 false 就 能 禁用 Actuator 的 全 部 端点 ,然后 
将 endpoints.metrics.enabled 设 置 为 true 重 新 启用 /metrics 端 点 。 











7.4.3 添加 自 定义 度量 信息 


在 7.1.2 节 中 ， 你 看 到 了 如 何 从 /metrics 端 点 获得 运行 中 应 用 程序 的 内 部 度量 信息 ， 包 括 内 存 、 
垃圾 回收 和 线程 信息 。 这 些 都 是 非常 有 用 且 信 息 量 很 大 的 度量 值 ,但 你 可 能 还 想 定义 自己 的 度量 ， 
用 来 捕获 应 用 程序 中 的 特定 信息 。 

比方 说 , 我 们 想 要 知道 用 户 往 阅 读 列 表 里 保存 了 多 少 次 图 书 , 最 简单 的 方法 就 是 在 每 次 调用 
ReadingListControllerlfjaddToReadingList () 方 法 时 增加 计数 器 值 。 计 数 器 很 容易 实现 ， 
但 这 个 不 断 变化 的 总 计 值 如 何 同 /metrics 端 点 发 布 的 度量 信息 一 起 发 布 出 来 呢 ? 

再 假设 我 们 想 要 获得 最 后 保存 图 书 的 时 间 戳 。 时 间 戳 可 以 通过 调用 System. current Time- 
Millis() 来 获取 ， 但 如 何在 /metrics 端 点 里 报告 该 时 间 戳 呢 ? 
实际 上 , 自动 配置 允许 Actuator 创 建 counterservice 的 实例 , 并 将 其 注册 为 Spring 的 应 用 程 
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序 上 下 文中 的 Bean。counterService 这 个 接口 里 定义 了 三 个 方法 ,分 别 用 来 增加 、 减 少 或 重 置 
特定 名 称 的 度量 值 ， 代 码 如 下 : 


package org.springframework.boot.actuate.metrics; 





public interface CounterService { 
void increment(String metricName); 
void decrement(String metricName); 
void reset (String metricName); 


} 
Actuator 的 自动 配置 还 会 配置 一 个 GaugeService 类 型 的 Bean。 该 接口 与 CounterServic 
类 似 ， 能 将 某 个 值 记录 到 特定 名 称 的 度量 值 里 。 GaugeService 看 起 来 是 这 样 的 : 


package org.springframework.boot.actuate.metrics; 


























public interface GaugeService ( 
void submit(String metricName, double value); 


} 

你 无 需 实现 这 些 接口 。Spring Boot 已 经 提供 了 两 者 的 实现 。 我们 所 要 做 的 就 是 把 它们 的 实例 
注入 所 需 的 Bean， 在 适当 的 时 候 调用 其 中 的 方法 ， 更 新 想 要 的 度量 值 。 

针对 上 文 提 到 的 需求 ， 我 们 需要 把 counterservice 和 GaugeService Bean 注 人 Reading- 
ListController, 然后 在 addToReadingList() 方 法 里 调用 其 中 的 方法 。 代 码 清 单 7-9 是 
ReadingListController 里 的 相关 变动 : 




















代码 清单 7-9 ”使 用 注入 的 counterservice 和 GaugeService 
@Controller 
GRequestMapping("/") 
GConfigurationProperties("amazon") 
public class ReadingListController ( 


private CounterService counterService; 


GAutowired 
public ReadingListController( 
ReadingListRepository readingListRepository, 


AmazonProperties amazonProperties, 注入 
CounterService counterService, uc T 
GaugeService gaugeService) ( GaugeService 


this.readingListRepository - readingListRepository; 
this.amazonProperties - amazonProperties; 
this.counterService - counterService; 
this.gaugeService - gaugeService; 


GRequestMapping (method-RequestMethod.POST) 
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public String addToReadingList(Reader reader, Book book) ( 
book.setReader(reader); 


readingListRepository.save(book); . 
增加 books .saved 的 值 


counterService.increment("books.saved"); < 


gaugeService.submit( 
"books.last.saved", System.currentTimeMillis()); < 一 


: 记录 books .last.saved 
return "redirect:/"; 


的 值 


j 


修改 后 的 ReadingListcontrollez 使 用 了 自动 织 人 机制 ， 通 过 控制 器 的 构造 方法 注入 
CounterService 和 GaugeSservice， 随 后 把 它们 保存 在 实例 变量 里 。 此 后 ，aqaToReading- 
List() 方 法 每 次 处 理 请 求 时 都 会 调用 counterservice.increment ("books.saved") 和 
gaugeService.submit("books. last.saved") 来 调整 度量 值 。 

尽管 counterservice 和 GaugeService 用 起 来 很 简单 , 但 还 是 有 一 些 度量 值 很 难 通过 增加 
计数 需 或 记录 指标 值 来 捕获 。 对 于 那些 情况 ， 我 们 可 以 实现 PublicMetrics 接 口 ， 提 供 自己 需 
要 的 度量 信息 。 该 接口 定义 了 一 个 metrics () 方 法 ， 返 回 一 个 Metric 对 象 的 集合 : 


package org.springframework.boot.actuate.endpoint; 

















public interface PublicMetrics ( 
Collection«Metric«?»» metrics(); 


} 

el 这 里 假设 我 们 想 报 告 一 些 源 自 Spring 应 用 程序 上 下 文 的 
旦 序 上 下 文 启动 的 时 间 、Bean 及 Bean 定 义 的 数量 ， 这 些 都 包含 进来 会 很 有 意思 。 
顺便 再 报告 一 下 添加 了 econtroller 注 解 的 Bean 的 数量 。 人 代码 清单 7-10 给 出 了 相应 
PublicMetrics 实 现 的 代码 。 


代码 清单 7-10 ”发 布 自 定义 度量 信息 


package readinglist; 

















import java.util.ArrayList; 

import java.util.Collection; 

import java.util.List; 

import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.actuate.endpoint.PublicMetrics; 
import org.springframework.boot.actuate.metrics.Metric; 

import org.springframework.context.ApplicationContext; 

import org.springframework.stereotype.Component; 

import org.springframework.stereotype.Controller; 

GComponent 

public class ApplicationContextMetrics implements PublicMetrics ( 


private ApplicationContext context; 





AE 
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GAutowired 
public ApplicationContextMetrics(ApplicationContext context) 
this.context context; 


} 


{ 

















GOverride 
public Collection«Metric«?»» metrics() ( 记录 启动 时 间 
List«Metric«?»» metrics = new ArrayList«Metric«?»»(); 
metrics.add(new Metric«Long»("spring.context.startup-date", 
context.getStartupDate())); 
Td 记录 Bean 定 
metrics.add(new Metric«Integer»("spring.beans.definitions", 义 数量 
context.getBeanDefinitionCount())); 
metrics.add(new Metric«Integer»("spring.beans", 
context.getBeanNamesForType (Object.class).length)); 
记录 Bean 数 量 
metrics.add(new Metric«Integer»("spring.controllers", 
context.getBeanNamesForAnnotation(Controller.class).length)); 4 
return metrics; 记录 控制 器 类 





型 的 Bean 数 量 


} 





Actuator 会 调用 metrics () 方 法 , 收集 Application 


ContextMetric s 提 供 的 度量 信息 o dX 


方法 调用 了 所 注入 的 applicationcontext 上 的 方法 ， 获 取 我 们 想 要 报告 为 度量 的 数量 。 每 个 
度量 值 都 会 创建 一 个 Metrics 实 例 ， 指 定 度量 的 名 称 和 值 ， 将 其 加 入 要 返回 的 列表 。 

fi ffApplicationContextMetrics, 并 在 ReadingListcontroller 里 使 用 counter- 
Service 和 GaugeService 之 后 ,我们 可 以 在 /metrics 端 点 的 响应 中 找到 如 下 条 目 : 


{ 


spring.context.startup-date: 


1429398980443, 
spring.beans.definitions: 261, 
spring.beans: 272, 
spring.controllers: 2, 
books.count: 1, 
gauge.books.save.time: 1429399793260, 


} 








Tec 


这 些 度量 的 实际 值 会 根据 添加 了 多 少 书 、 何 时 启动 应 用 程序 及 何 时 保存 最 后 一 本 书 而 





发 生变 化 。 在 这 个 例子 里 ， 你 一 定 会 好 奇 为 什么 spring .controllers 是 2。 因 为 这 里 算 上 了 


ReadingListController 以 及 Spring Boot 提 供 的 Basici 


7.4.4 创建 自 定义 跟踪 仓库 


默认 情况 下 ，/trace 端 点 报告 的 跟踪 信 ， 
就 开始 移 除 老 的 条 目 ， 给 


A 


H 


7 





T5 


， f 


息 都 存储 在 内 存 仓库 里 ，100 个 条 目 3 
新 的 条 目 腾 出 空间 。 在 开发 阶段 这 没什么 问题 ,但 在 生产 环境 中 ， 





ErrorControllers 





EFT o 一 旦 仓库 满 
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大 流量 会 造成 跟踪 信息 还 没 来 得 及 看 就 被 丢弃 。 
为 了 避免 这 个 问题 ， 你 可 以 声明 自己 的 InMemoryTraceRepository Bean， 将 它 的 容量 调 
整 至 100 以 上 。 如 下 配置 类 可 以 将 容量 调整 至 1000 个 条 目 : 








package readinglist; 

import org.springframework.boot.actuate.trace.InMemoryTraceRepository; 
import org.springframework.context.annotation.Bean; 

import org.springframework.context.annotation.Configuration; 


QGConfiguration 
public class ActuatorConfig ( 


GBean 

public InMemoryTraceRepository traceRepository() ( 
InMemoryTraceRepository traceRepo - new InMemoryTraceRepository(); 
traceRepo.setCapacity (1000); 
return traceRepo; 


) 


) 
仓库 容量 翻 了 10 倍 ,跟踪 信息 的 保存 时 间 应 该 会 更 入。 不过， 繁忙 到 一 定 程度 ， 应 用 程序 还 


是 可 能 在 你 查看 这 些 信 息 前 将 其 丢弃 。 这 是 一 个 内 存 存储 的 仓库 ,还 要 避免 容量 增长 太 多 ,影响 
应 用 程序 的 内 存 使 用 。 

除了 上 述 方法 , 我 们 还 可 以 将 那些 跟踪 条 目 存储 在 其 他 地 方 一 一 既 不 消耗 内 存 ,又 能 长 久保 
存 的 地 方 。 只 需 实现 Spring Boot 的 TraceRepository 接 口 即 可 ; 





package org.springframework.boot.actuate.trace; 
import java.util.List; 
import java.util.Map; 


public interface TraceRepository ( 
List«Trace» findAl11(); 
void add(Map«String, Object» traceInfo); 
} 


如 你 所 见 ，TraceRepository 只 要 求 我 们 实现 两 个 方法 : 一 个 方法 查找 所 有 存储 的 Trace 
对 象 ， 另 一 个 保存 了 一 个 Trace， 包 含 跟踪 信息 的 Map 对 象 。 

作为 演示 , 假设 我 们 创建 了 一 个 使 用 MongoDB 数 据 库 存储 跟踪 信息 的 TraceRepository 实 
例 。 代 码 清单 7-11 演 示 了 如 何 实现 这 个 TraceRepository。 


代码 清单 7-11 往 MongoDB 保 存 跟踪 数据 
package readinglist; 
import java.util.Date; 
import java.util.List; 
import java.util.Map; 
import org.springframework.beans.factory.annotation.Autowired; 
import org.springframework.boot.actuate.trace.Trace; 
import org.springframework.boot.actuate.trace.TraceRepository; 
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import org.springframework.data.mongodb.core.MongoOperations; 
import org.springframework.stereotype.Service; 


GService 
public class MongoTraceRepository implements TraceRepository { 


private MongoOperations mongoOps; 


MongoOperations 


GAutowired 注入 
public MongoTraceRepository (MongoOperations mongoOps) ( 
this.mongoOps - mongoOps; 


} 


GOverride " 
public List«Trace» findAl1l() ( | 获取 所 有 跟踪 条 目 
return mongoOps.findAll(Trace.class); < 一 一 


} 


GOverride 


— AN BE nes 
public void add(Map«String, Object» traceInfo) ( 保存 一 个 跟踪 条 目 


mongoOps.save(new Trace(new Date(), traceInfo)); 


} 


} 





findall () 方 法 很 直 白 ， 用 注入 的 Mongooperations 来 查找 全 部 Trace 对 象 。add () 方 法 
稍微 有 趣 一 点 ， 用 当前 时 间 和 含有 跟踪 信息 的 Map 创 建 了 一 个 Trace 对 象 ， 然 后 通过 
MongoOperations.save( ) 将 其 保存 下 来 。 唯一 的 问题 是 , MongoOperat ions 是 哪里 来 的 ? 
































为 了 使 用 MongoTraceRepository ， 我 们 需要 保证 Spring 应 用 程序 上 下 文 里 先 有 一 个 





MongoOperations Bean。 得 益 于 Spring Boot 的 起 步 依赖 和 自动 配置 ， 做 到 这 一 





MongoDB 起 步 依 赖 即 可 。 你 需要 如 下 Gradle 依 赖 : 


compile("org.springframework.boot:spring-boot-starter-data-mongodb") 


如 果 你 用 的 是 Maven， 则 需要 如 下 依赖 : 


<dependency> 
<groupId>org.springframework.boot</groupId> 
<artifactId>spring-boot-starter-data-mongodb</artifactId> 

</dependency> 





点 只 需 添 加 


添加 了 这 个 起 步 依 赖 后 ，Spring Data MongoDB 和 所 依赖 的 库 会 添加 到 应 用 程序 的 Classpath 
里 。Spring Boot 会 自动 配置 所 需 的 Bean， 以 便 使 用 MongoDB 数 据 库 。 这 些 Bean 里 就 包括 
Mongooperations。 另 外 ,你 需要 确保 和 Mongooperat ions 通 讯 的 MongoDB 服 务 右 正常 运行 。 
































7.4.5 插入 自 定义 健康 指示 器 





如 前 文 所 述 ，Actuator 自 带 了 很 多 健康 指示 咒 ， 能 满足 常见 需求 ， 比 如 报告 应 用 程序 使 用 的 





数据 库 和 消息 代理 的 健康 情况 。 但 如 果 你 的 应 用 程序 需要 和 一 些 没 有 健康 指示 器 的 系统 交互 , 那 
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该 怎么 办 呢 ? 

我 们 的 阅读 列表 里 有 指向 Amazon 的 图 书 链接 ， 可 以 报告 一 人 Amazon 是 否 可 以 访问 。 当 然 ， 
Amazon 不 太 可 能 宕 机 ,但 不 怕 一 万 就 怕 万 一 ， 所 以 让 我 们 为 Amazon 创 建 一 个 健康 指示 器 吧 。 代 
人 码 清单 7-12 演 示 了 相关 HealthIndicator 的 实现 。 


代码 清单 7-12” 自 定义 一 个 Amazon 健 康 指 示 器 
package readinglist; 
import org.springframework.boot.actuate.health.Health; 
import org.springframework.boot.actuate.health.HealthIndicator; 
import org.springframework.stereotype.Component; 
import org.springframework.web.client.RestTemplate; 





























GComponent 
public class AmazonHealth implements HealthIndicator ( 


GOverride 
public Health health() ( 
try ( 向 Amazon 发 
RestTemplate rest = new RestTemplate(); 送 请 求 
rest.getForObject("http://www.amazon.com", String.class); 


return Health.up().build(); 
) catch (Exception e) ( 
return Health.down().build(); < 一 一 
) | 报告 pom 状态 


} 
AmazonHealth 类 并 没有 什么 花哨 的 地 方 。healtn () 方 法 只 是 使 用 Spring 的 RestTemplate 
向 Amazon 首 页 发 起 了 一 个 GET 请 求 。 如 果 请 求 成 功 , 则 返回 一 个 表明 Amazon 状 态 为 UP 的 Health 
对 象 。 如 果 请 求 发 生 异 常 ， 则 health() 返 回 一 个 标明 Amazon 状 态 为 DowN 的 Health 对 象 。 
下 面 是 /health 端 点 响应 的 一 个 片段 。 这 里 可 以 看 出 ， 如 果 Amazon 不 可 访问 ， 你 会 看 到 什么 。 
{ 





























"amazonHealth": ( 
"status": "DOWN" 
), 
| 
你 不 会 相信 我 等 Amazon 宕 机 等 了 多 和 久 ， 就 为 了 能 看 到 上 面 的 结果 ! O 
除了 简单 的 状态 之 外 ， 如 果 你 还 想 向 健康 记录 里 添加 其 他 附加 信息 ， 可 以 调用 Health 构 造 
髓 的 withDetail() 方 法 。 例 如 ， 要 添加 异常 消息 ， 将 其 作为 健康 记录 的 reason 字 段 ， 可 以 让 
catch 块 返回 这 样 一 个 Health 对 象 ; 


return Health.down().withDetail("reason", e.getMessage()).build(); 

















实际 上 我 并 没有 等 太 久 。 我 只 是 把 电脑 的 网 络 断 开 了 。 没 有 网 就 没有 Amazon。 





136 第 7 章 深入 Actuator 





修改 后 ， 当 Amazon 无 法 访问 时 ， 健 康 记录 看 起 来 是 这 样 的 : 


"amazonHealth": ( 
"reason": "I/O error on GET request for 
NV"http://www.amazon.com V" :www.amazon.com; 
nested exception is java.net.UnknownHostException: 
www.amazon.com", 
"status": "DOWN" 
Jw 


如 果 有 很 多 附加 信息 ， 可 以 多 次 调用 withpetail() 方 法 ,每 次 设置 一 个 要 放 和 健康 记录 的 
附加 字段 。 


7.5 保护 Actuator 端点 


很 多 Actuator 端 点 发 布 的 信息 都 可 能 涉及 敏感 数据 , 还 有 一 些 端点 ，( 比如 /shutdown ) 非常 危 
险 ， 可 以 用 来 关闭 应 用 程序 。 因 此 ,保护 这 些 端 点 尤为 重要 ， 能 访问 它们 的 只 能 是 那些 经 过 授权 
的 客户 端 。 

实际 上 ，Actuator 的 端点 保护 可 以 用 和 其 他 URL 路 径 一 样 的 方式 一 一 使 用 Spring Security, TE 
Spring Boot 应 用 程序 中 ， 这 意味 着 将 Security 起 步 依 赖 作为 构建 依赖 加 入 ， 然 后 让 安全 相关 的 自 
动 配置 来 保护 应 用 程序 ， 其 中 当然 也 包括 了 Actuator 端 点 。 

在 第 3 章 , 我 们 看 到 了 默认 安全 自动 配置 如 何 把 所 有 URL 路 径 保护 起 来 , 要 求 HTTP 基 本 身份 
验证 , 用 户 名 是 user, 密码 在 启动 时 随机 生成 并 写 到 日 志文 件 里 去 。 这 不 是 我 们 所 希望 的 Actuator 
保护 方式 。 

我 们 已 经 添加 了 一 些 自 定义 安全 配置 , 仅 限 带 有 READER 权 限 的 授权 用 访问 根 URL 路 径 (/)。 
要 保护 Actuator 的 端点 ， 我 们 需要 对 securityconfig.java 的 configure() 方 法 做 些 修改 。 

举例 来 说 ， 你 想 要 保护 /shutdown 端 点 ， 仅 允许 拥有 ADMIN 权 限 的 用 户 访问 ， 代 码 清单 7-13 
就 是 新 的 configure () 方 法 。 


代码 清单 7-13 ”保护 /shutdown 端 点 



































GOverride 
protected void configure(HttpSecurity http) throws Exception ( 
http 
.authorizeRequests() 
.antMatchers("/").access("hasRole('READER')") 
.antMatchers("/shutdown").access("hasRole('ADMIN')") < 一 要 求 有 ADMIN 
.antMatchers("/**").permitAll() 权限 
.and() 
.formLogin() 


.loginPage("/login") 
.failureUrl("/login?error-true"); 


} 


现在 要 访问 /shutdown 端 点 ， 必 须 用 一 个 带 ADMIN 权 限 的 用 户 来 做 身份 验证 。 
然而 , 第 3 章 里 的 自 定义 UserDetailsSservice 只 对 通过 ReadqerRepositorvy 加 载 的 用 户 赋 
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予 READER 权 限 。 因 此 ， 你 需要 创建 一 个 更 聪明 的 UserDpetailsservice 实 现 ， 对 某 些 用 户 赋 
予 ADMIN 权 限 。 你 可 以 配置 一 个 额外 的 身份 验证 实现 ， 比 如 代码 清单 7-14 里 的 内 存 实现 。 


代码 清单 7-14 ”添加 一 个 内 存 里 的 admin 用 户 


@Override 
protected void configure ( 
AuthenticationManagerBuilder auth) throws Exception { 





auth 
.userDetailsService(new UserDetailsService() ( < 一 
GOverride 
public UserDetails loadUserByUsername(String username) 
throws UsernameNotFoundException { 
UserDetails user - readerRepository.findOne(username); 
if (user !- null) ( 
return user; 
} 
throw new UsernameNotFoundException( 
"User '" + username + "' not found."); 


Reader £ 3s 
证 


} 
}) 
.and() 
.inMemoryAuthentication() 
.withUser("admin").password("s3cr3t") Admin 身 份 验证 
.YOles("ADMIN", "READER"); 一 一 
} 


新 加 的 内 存 身份 验证 中 , 用 户 名 定义 为 admin, 密码 为 83cr3t, 同时 被 授予 ADMIN 和 READER 
权限 。 

现在 , 除了 那些 拥有 ADMIN 权 限 的 用 户 ， 谁 都 无 法 访问 /shutdown 端 点 。 但 Actuator 的 其 他 端 
点 呢 ? 假设 你 只 想 让 ADMIN 的 用 户 访问 它们 ( 像 /shutdown 一 样 )， 可 以 在 调用 antMatchers () 
时 列 出 这 些 URL。 例 如 ， 要 保护 /metrics 、/confiprops 和 /shutdown ， 可 以 像 这 样 调 用 


antMatchers(): 











.antMatchers("/shutdown", "/metrics", "/configprops") 
.access("hasRole('ADMIN') ") 


虽然 这 么 做 能 奏效 ， 但 也 只 适用 于 少数 Actuator 端 点 的 保护 。 如 果 要 保护 全 部 Actuator 端 点 ， 
这 种 做 法 就 不 太 方便 了 。 

比 起 在 调用 antMatchers () 方 法 时 显 式 地 列 出 所 有 的 Actuator 端 点 , 用 通配符 在 一 个 简单 的 
Ant 风 格 表 达 式 里 匹配 全 部 的 Actuator 端 点 更 容易 。 但 是 ,这 么 做 也 小 有 点 挑战 ， 因 为 不 同 的 端点 
路 径 之 间 没 有 什么 共同 点 ， 我 们 也 不 能 在 /** 上 运用 ADMIN 权 限 。 这 样 一 来 ， 除 了 根 路 径 (/) 
之 外 ， 什 么 要 有 ADMIN 权 限 。 

为 此 , 可 以 通过 management .context -path 属性 设置 端点 的 上 下 文 路 径 o 默认 情况 下 , 这 
个 属性 是 空 的 ， 所 以 Actuator 的 端点 路 径 都 是 相对 于 根 路 径 的 。 在 application.yaml 里 增加 如 下 内 
容 ， 可 以 让 这 些 端 点 都 带 上 /mgmt 前 级 。 


















































138 第 7 章 深入 Actuator 





management : 
context-path: /mgmt 


你 也 可 以 在 application.properties 里 做 类 似 的 事情 : 
management.context-path-/mgmt 


将 management .context-path 设 置 为 /ngmt 后 ， 所 有 的 Actuator 端 点 都 会 与 Amngmt 路 径 相 
关 。 例 如 ，/metrics 端 点 的 URL 会 变 为 /mgmt/metrics。 

有 了 这 个 新 的 路 径 ， 我 们 就 有 了 公共 的 前 级 ,在 为 Actuator 端 点 赋予 ADMIN 权 限 限 制 时 就 能 
借助 这 个 公共 前 级 : 

.antMatchers("/mgmt/**").access("hasRole('ADMIN')") 


现在 所 有 以 /mgmt 开 头 的 请 求 ( 包含 了 所 有 的 Actuator 端 点 ) 都 只 让 授予 了 ADMIN 权 限 的 认 
证 用 户 访问 。 


7.6 小 结 


想 弄 清楚 运行 的 应 用 程序 里 正在 发 生 什 么 ， 这 是 件 很 困难 的 事 。Spring Boot 的 Actuator 为 你 
打开 了 一 扇 大 门 ,深入 Spring Boot 应 用 程序 的 内 部 细节 。 它 发 布 的 组 件 、 度 量 和 指标 能 帮 你 理解 
应 用 程序 的 运作 情况 。 

在 本 章 , 我 们 先 了 解 了 Actuator 的 Web 端 点 一 一 通过 HTTP 发 布 运行 时 细节 信息 的 REST 端 点 。 
这 些 端点 的 功能 包括 查看 Spring 应 用 程序 上 下 文 里 所 有 的 Bean 、 查 看 自动 配置 决策 、 查 看 Spring 
MVC 映 射 、 查 看 线程 活动 、 查 看 应 用 程序 健康 信息 ， 还 有 多 种 度量 、 指 标 和 计数 器 。 

除了 Web 端 点 , Actuator 还 提供 了 另外 两 种 获取 它 所 提供 信息 的 途径 。 远程 shell 让 你 能 在 shell 
里 安全 地 连 上 应 用 程序 ， 发 起 指令 ， 获 得 与 Actuator 端 点 相同 的 数据 。 与 此 同时 ， 所 有 的 Actuator 
端点 也 都 发 布 成 了 JMBean， 可 以 通过 JMX 客 户 端 进行 监控 和 管理 。 

随后 我 们 还 了 解 了 如 何 定制 Actuator, 包括 如 何 通过 端点 的 ID 来 修改 Actuator 端 点 的 路 径 , 如 
何 启 用 和 禁用 端点 , 诸如 此 类 。 我 们 还 插入 了 一 些 定制 的 度量 信息 , 创建 了 定制 的 跟踪 信息 仓库 ， 
替换 了 默认 的 内 存 跟踪 仓库 。 

最 后 ， 我 们 学 习 了 如 何 保护 Actuator 的 端点 ， 只 让 经 过 授权 的 用 户 访问 它们 。 

接 下 来 ， 在 第 8 章 里 ， 我 们 将 看 到 如 何 让 应 用 程序 从 编码 阶段 过 渡 到 生产 阶段 ， 了 解 Spring 
Boot 如 何 协助 我 们 在 多 种 不 同 的 平台 上 进行 部 署 ， 包 括 传统 的 应 用 容器 和 云 平台 。 
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本 章 内 容 

口 部 署 WAR 文 件 

口 数据 库 迁 移 

a 部 署 到 云端 

想 一 想 你 喜欢 的 动作 电影 。 现 在 假设 你 要 去 电影 院 看 这 部 电影 ,享受 视听 震撼 。 片 中 有 高 速 
逐 、 爆 炸 和 激战 。 好 人 还 没 战胜 坏人 ,一切 偏偏 看 然而 止 。 还 没 等 影片 里 的 冲突 解决 ， 电 影院 








URT. 大 家 都 被 领 出 门 外 。 

虽然 前 面 的 铺垫 很 精彩 ， 但 电影 的 高 潮 才 是 最 重要 的 。 没 有 了 它 ， 就 是 为 了 动作 而 动作 了 。 

现在 , 想象 你 正在 开发 应 用 程序 , 为 解决 某 个 业务 问题 投入 了 很 多 精力 和 创造 力 , 但 最 终 没 
能 部 署 应 用 程序 , 没 能 让 别人 使 用 这 个 程序 并 乐 在 其 中 。 当 然 , 我 们 应 用 程序 大 多 没有 汽车 追逐 
和 爆炸 〈 至 少 我 希望 是 这 样 的 )， 但 一 路 上 我 们 也 会 争分夺秒 。 当 然 ， 并 非 每 行 代码 都 为 生产 环 
境 而 写 ， 但 什么 都 不 部 署 也 挺 让 人 失望 的 。 

din IE, 我 们 的 焦点 都 集中 在 使 用 Spring Boot 的 特性 帮助 大 家 开发 应 用 程序 。 我 们 遇 到 了 
不 少 惊喜 。 但 如 果 不 越 过 终点 线 ， 应 用 程序 没有 部 署 ， 这 一 切 都 是 徒劳 。 

ps 我 们 会 在 使 用 Spring Boot 开 发 应 用 程序 的 基础 上 更 进一步 ， 讨 论 如 何 部 署 那些 应 用 
程序 。 虽 然 这 对 部 署 过 基于 Java 的 应 用 程序 的 人 来 说 并 无 特别 之 处 , 但 Spring Boot 和 相关 的 Spring 
项 目 中 有 些 独特 的 功能 ， 基 于 这 些 功 能 我 们 可 以 让 Spring Boot 应 用 程序 的 部 署 变 得 与 众 不 同 。 

实际 上 ， 大 部 分 Java Web 应 用 程序 都 以 WAR 文 件 的 形式 部 署 到 应 用 服务 器 上 。Spring Boot 
提供 的 部 署 方式 则 有 所 不 同 ， 后 者 在 部 署 上 提供 了 不 少 选择 。 在 了 解 如 何 部 署 Spring Booth HFE 
序 之 前 ， 让 我 们 看 看 这 些 可 选 方式 ， 找 出 能 满足 我 们 需求 的 那些 选项 。 


8.1 衡量 多 种 部 署 方式 


Spring Boot 应 用 程序 有 多 种 构建 和 运行 方式 ， 其 中 一 些 你 已 经 使 用 过 了 。 
a 在 IDE 中 运行 应 用 程序 ( 涉及 Spring ToolSuite 或 IntelliJ IDEA )。 
a 使 用 Maven 的 spring-boot :run 或 Gradle 的 bootRun， 在 命令 行 里 运行 。 DN 
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口 使 用 Maven 或 Gradle 生 成 可 运行 的 JAR 文 件 ， 随 后 在 命令 行 中 运行 。 
口 使 用 Spring Boot CLI 在 命令 行 中 运行 Groovy 脚 本 。 
O 使 用 Spring Boot CLI 来 生成 可 运行 的 JAR 文 件 ， 随 后 在 命令 行 中 运行 。 

这 些 选项 每 一 个 都 适合 运行 正在 开发 的 应 用 程序 。 但 是 , 如 果 要 将 应 用 程序 部 署 到 生产 环境 
或 其 他 非 开发 环境 中 ， 又 该 怎么 办 呢 ? 

虽然 这 些 选 项 看 起 来 没有 一 个 能 将 应 用 部 署 于 非 开 发 环境 , 但 事实 上 , 它们 之 中 只 有 一 个 选 
项 不 可 用 于 生产 环境 在 IDE 中 运行 应 用 显然 不 可 取 。 可 运行 的 JAR 文 件 和 Spring Boot CLI 还 是 
可 以 考虑 的 ， 两 者 还 可 以 很 好 地 将 应 用 程序 部 署 到 云 环 境 里 。 

也 许 你 很 想 知道 如 何 把 Spring Boot 应 用 程序 部 署 到 一 个 更 加 传统 的 应 用 服务 器 环境 里 ， 比 如 
Tomcat、WebSphere 或 WebLogic。 在 这 些 情境 中 ， 可 执行 JAR 文 件 和 Groovy 代 码 不 适用 。 针 对 应 
用 服务 器 的 部 署 ， 你 需要 将 应 用 程序 打包 成 一 个 WAR 文 件 。 

实际 上 ，Spring Boot 应 用 程序 可 以 用 多 种 方式 打包 ， 详 见 表 8-1。 


表 8-1 Spring Boot 部 署 选项 
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部 署 产物 产生 方式 目标 环境 
Groovy 源 码 手写 Cloud Foundry 及 容器 部 署 ， 比 如 Docker 
可 执行 JAR Maven, 、Gradle 或 Spring Boot CLI ， 云 环境 ， 包 括 Cloud Foundry 和 Heroku， 还 有 容器 部 署 ， 比 如 Docker 
WAR Maven 或 Gradle Java 应 用 服务 器 或 云 环 境 ， 比 如 Cloud Foundry 





如 你 所 见 ， 在 做 最 终 选择 时 需要 考虑 目标 环境 。 如 果 要 将 应 用 程序 部 署 到 自己 数据 中 心 的 
Tomcat 服 务 器 上 ，WAR 文 件 就 是 你 的 选择 。 另 一 方面 ， 如 果 要 部 署 到 Cloud Foundry， 可 以 使 用 
表 里 列 出 的 各 种 选项 。 

本 章 将 关注 以 下 选项 。 

口 向 Java 应 用 服务 器 里 部 署 WAR 文 件 。 
口 向 Cloud Foundry 里 部 署 可 执行 JAR 文 件 。 
O 向 Heroku 里 部 署 可 执行 JAR 文 件 ( 构建 过 程 是 由 Heroku 执 行 的 )。 

探索 这 些 场景 的 时 候 ， 我 们 还 要 处 理 一 件 事 。 在 开发 应 用 程序 时 我 们 使 用 了 般 入 式 的 H2 数 
据 库 ， 现 在 得 把 它 替 换 成 生产 环境 所 需 的 数据 库 了 。 

首先 ,让 我 们 看 看 如 何 将 阅读 列表 应 用 程序 构建 为 WAR 文 件 。 这 样 才 能 把 它 部 署 到 Java 应 用 
服务 器 里 ， 比 如 Tomcat、WebSphere 或 WebLogic。 


8.2 ”部 署 到 应 用 服务 器 


到 目前 为 止 , 阅读 列表 应 用 程序 每 次 运行 ，Web 应 用 程序 都 通过 内 骨 在 应 用 里 的 Tomcat 提 供 
服务 。 情 况 和 传统 Java Web 应 用 程序 正好 相反 。 不 是 应 用 程序 部 署 在 Tomcat 里 ， 而 是 Tomcat 部 署 
在 了 应 用 程序 里 。 

归功 于 Spring Boot 的 自动 配置 功能 ,我 们 不 需要 创建 web.xml 文 件 或 者 Servlet 初 始 化 类 来 声明 
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Spring MVC 的 DispatcherServlet。 但 如 果 要 将 应 用 程序 部 署 到 Java 应 用 服务 器 里 ， 我 们 就 需 
要 构建 WAR 文 件 了 。 这 样 应 用 服务 器 才能 知道 如 何 运行 应 用 程序 。 那 个 WAR 文 件 里 还 需要 一 个 
对 Servlet 进 行 初始 化 的 东西 。 





8.2.1 构建 WAR 文件 


KRE, 构建 WAR 文 件 并 不 困难 。 如 果 你 使 用 Gradle 来 构建 应 用 程序 ， 只 需 应 用 WAR 插 件 
即 可 : 
apply plugin: 'war' 


随后 ， 在 build.gradle 里 用 以 下 wa 配置 蔡 换 原 来 的 jar 配 置 ， 




















war { 
baseName - 'readinglist' 
version - '0.0.1-SNAPSHOT' 


) 
两 者 的 唯一 区 别 就 是 7 换 成 了 w。 

如 果 使 用 Maven 构 建 项 目 ， 获 取 WAR 文 件 会 更 容易 。 只 需 把 <packaging> 元 素 的 值 从 jar 
改 为 war。 


«packaging»war«/packaging» 


这 样 就 能 生成 WAR 文 件 了 。 但 如 果 WAR 文 件 里 没有 启用 Spring MVC DispatcherServlet 
的 web.xml 文 件 或 者 Servlet 初 始 化 类 ， 这 个 WAR 文 件 就 一 无 是 处 。 

此 时 就 该 Spring Boot 出 马 了 。 它 提供 的 springBootServletInitializer 是 一 个 支持 
Spring Boot 的 Spring WebApplicationInitializer 实 现 。 除 了 配置 Spring 的 Dispatcher- 
Servlet, SpringBootServletInitializer 还 会 在 Spring 应 用 程序 上 下 文 里 查找 Filter、 
Servlet 或 ServletContextInitializer 类 型 的 Bean， 把 它们 绑 定 到 Servlet 容 器 里 。 

要 使 用 springBootServl etInitializer, 只 需 创 建 一 个 子 类 ， 1 xiconfigure( () 方 法 
来 指定 Spring 配置 类 。 代码 清单 8-1 是 ReadqingListservletInitializer， 也 就 是 我 们 为 阅读 
列表 应 用 程序 写 的 springBootServletInitializer 的 子 类 。 


代码 清单 8-1 为 阅读 列表 应 用 程序 扩展 springBootServletInitializet 


package readinglist; 
import org.springframework.boot.builder.SpringApplicationBuilder; 
import org.springframework.boot.context.web.SpringBootServletInitializer; 
































public class ReadingListServletInitializer 
extends SpringBootServletInitializer ( 


GOverride 
protected SpringApplicationBuilder configure( 
SpringApplicationBuilder builder) ( 
return builder.sources(Application.class); 二 一 一 一 EE 





旨 定 Spring 配置 
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} 


如 你 所 见 ，configure() 方 法 传人 了 一 个 springApplicationBuilder 参 数 , 并 将 其 作为 
结果 返回 。 期 间 它 调用 sources () 方法 注册 了 一 个 Spring 配置 类 。 本 例 只 注册 了 一 个 
Application 类 。 回 想 一 下 ， 这 个 类 既是 启动 类 ( 带 有 main () 方 法 )， 也 是 一 个 Spring 配置 类 。 
虽然 阅读 列表 应 用 程序 里 还 有 其 他 Spring 配置 类 ， 但 没有 必要 在 这 里 把 它们 全 部 注册 进来 。 
Application 类 上 添加 了 @SpringBootApplication 注 解 。 这 会 隐 性 开启 组 件 扫描 ， 而 组 件 扫 
描 则 会 发 现 并 应 用 其 他 配置 类 。 

现在 我 们 可 以 构建 应 用 程序 了 。 如 果 使 用 Gradle， 你 只 需 调 用 build 任 务 即 可 : 


$ gradle build 


没 问 题 的 话 ， 你 可 以 在 build/libs 里 看 到 一 个 名 为 readinglist-0.0.1-SNAPSHOT.war 的 文件 。 
对 于 基于 Maven 的 项 目 ， 可 以 使 用 package: 


$ mvn package 


成 功 构 建 之 后 ， 你 可 以 在 target 目 录 里 找到 WAR 文 件 。 

剩 下 的 工作 就 是 部 署 应 用 程序 了 。 应 用 服务 器 不 同 ， 部 署 过 程 会 有 所 区 别 , 因此 请 参考 应 用 
服务 器 的 部 署 说 明文 档 。 
对 于 Tomcat 而 言 , 可 以 把 WAR 文 件 复制 到 Tomcat 的 webapps 目 录 里 。 如 果 Tomcat 正 在 运行 (要 
是 没有 运行 ， 则 在 下 次 启动 时 检测 )， 则 会 检测 到 WAR 文 件 ， 解 压 并 进行 安装 。 

假设 你 没有 在 部 署 前 重 命名 WAR 文 件 ， Servlet 上 下 文 路 径 会 与 WAR 文 件 的 主 文件 名 相同 ， 
在 本 例 中 是 /readinglist-0.0.1-SNAPSHOT。 用 你 的 浏览 器 打开 http://server:port/readinglist-0.0.1- 
SNAPSHOT 就 能 访问 应 用 程序 了 。 

还 有 一 点 值得 注意 : 就 算 我 们 在 构建 的 是 WAR 文 件 ， 这 个 文件 仍旧 可 以 脱离 应 用 服务 器 直 
接 运 行 。 如 果 你 没有 删除 application 里 的 main () 方 法 ,构建 过 程 生成 的 WAR 文 件 仍 可 直接 运 
行 ， 一 如 可 执行 的 JAR 文 件 : 

$ java -jar readinglist-0.0.1-SNAPSHOT.war 

这 样 一 来 ， 同 一 个 部 署 产 物 就 能 有 两 种 部 署 方式 了 ! 

现在 ， 应 用 程序 应 该 已 经 在 Tomcat 里 顺利 地 运行 起 来 了 。 但 是 它 还 在 使 用 内 骨 的 H2 数 据 库 。 
开发 应 用 程序 时 ， 艇 入 式 数据 库 很 好 用 , 但 对 生产 环境 而 言 这 不 是 一 个 明智 的 选择 。 让 我 们 来 看 
看 如 何在 部 署 到 生产 环境 时 选择 不 同 的 数据 源 。 
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8.2.2 创建 生产 Profile 
多 亏 了 自动 配置 ， 我 们 有 了 一 个 指向 能 入 式 H2 数 据 库 的 pataSsource Bean。 更 确切 地 说 ， 


DataSource Bean 是 一 个 数据 库 连 接 池 n 通常 是 org .apache.tomcat.jdbc.pool.DataSourceo 
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因此 ,很 明显 ， 要 使 用 艇 入 式 H2 之 外 的 数据 库 ， 我 们 只 需 声明 自己 的 DataSource Bean， 指 向 
我 们 选择 的 生产 数据 库 ， 用 它 覆 盖 自 动 配置 的 DataSource Bean. 

例如 , 假设 我 们 想 使 用 运行 localhost 上 的 PostgreSQL 数 据 库 ， 数据 库 名 字 是 readingList。 下 面 
的 @Bean 方 法 就 能 声明 我 们 的 DataSource Bean: 


@Bean 

@Profile ("production") 

public DataSource dataSource() { 
DataSource ds = new DataSource (); 
ds.setDriverClassName ("org.postgresql.Driver"); 
ds.setUrl("jdbc:postgresql://localhost:5432/readinglist"); 
ds.setUsername("habuma"); 
ds.setPassword("password"); 
return ds; 


} 














这 里 DataSource 的 类 型 是 Tomcat 的 org.apache.tomcat.jdbc.pool.DataSource, 不 
要 和 javax.sql.DataSource 搞 混 了 。 前 者 是 后 者 的 实现 。 连 接 数 据 库 所 需 的 细节 (包括 JDBC 
驱动 类 名 、 数 据 库 URL、 用 户 名 和 密码 ) 提供 给 了 patasourse 实 例 。 声 明了 这 个 Bean 之 后 ， 默 
认 自 动 配置 的 DataSource Bean 就 会 忽略 。 

这 个 @Bean 方 法 最 关键 的 一 点 是 ， 它 还 添加 了 @Profile 注 解 ， 说 明 只 有 在 broduction 
Profile 被 激活 时 才 会 创建 该 Bean。 所 以 ， 在 开发 时 我 们 还 能 继续 使 用 嵌入 式 的 H2 数 据 库 。 激 活 
productionProfile 后 就 能 使 用 PostereSQL 数 据 库 了 。 

虽然 这 人 么 做 能 达到 目的 ， 但 是 配置 数据 库 细 节 的 时 候 ， 最 好 还 是 不 要 显 式 地 声明 自己 的 
DataSource Bean 。 在 不 替换 自动 配置 的 Datasource Bean 的 情况 下 ， 我 们 还 能 通过 
application.yml 或 application.properties 来 配置 数据 库 的 细节 。 表 8-2 列 出 了 在 配置 DataSource 
Bean 时 用 到 的 全 部 属性 。 









































表 8-2 DataSource 配置 属性 











属性 〈 带 有 spring.datasource. 前 缀 ) 描 xk 
name 数据 源 的 名 称 
initialize 是 否 执行 data.sql (默认 : true) 
schema Schema (DDL) 脚本 资源 的 名 称 
data 数据 (DML) 脚本 资源 的 名 称 
sql-script-encoding 读 入 SQL 脚 本 的 字符 集 
platform 读 入 Schema 资 源 时 所 使 用 的 平台 (例如: schema-{platform}.sql) 
continue-on-error 如 果 初 始 化 失败 是 否 还 要 继续 (默认 : false) 
separator SQL 脚本 的 分 隔 符 (默认 : :) 
driver-class-name JDBC 驱 动 的 全 限定 类 名 (通常 能 通过 URL 自 动 推断 出 来 ) 
url 数据 库 URL 
username 数据 库 的 用 户 名 


password 数据 库 的 密码 
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(EE) 
属性 〈 带 有 spring.datasource. 前 组 ) Wo B 
jndi-name 通过 JNDI 查 找 数据 源 的 JNDI 名 称 
max-active 最 大 的 活跃 连接 数 (默认 :100) 
max-idle 最 大 的 闲置 连接 数 (默认 : 8) 
min-idle 最 小 的 闲置 连接 数 (默认 : 8) 
initial-size 连接 池 的 初始 大 小 (默认: 10) 
validation-query 用 来 验证 连接 的 查询 语句 
test-on-borrow 从 连接 池 借用 连接 时 是 否 检查 连接 (默认 ，false) 
test-on-return 向 连接 池 归 还 连接 时 是 否 检 查 连接 (上 默认: false) 
test-while-idle 连接 空 闪 时 是 否 测 试 连接 (默认 : false) 
time-between-eviction-runs-millis ZA (单位 为 毫秒 ) 清理 一 次 连接 (默认 : 5000) 
min-evictable-idle-time-millis ”在 被 测试 是 否 要 清理 前 ， 连 接 最 少 可 以 空 闪 多 久 (单位 为 毫秒 ， 默 认 ， 
60000) 
max-wait 当 没有 可 用 连接 时 ， 连 接地 在 返回 失败 前 最 多 等 多 久 (单位 为 毫秒 ,上 黑 
jk: 30000) 
jmx-enabled 数据 源 是 否 可 以 通过 JMX 进 行 管理 (默认 : false) 
表 8-2 里 的 大 部 分 属性 都 是 用 来 微调 连接 池 的 。 怎 么 设置 这 些 属性 以 适应 你 的 需要 ， 这 就 交 














给 你 来 解决 了 。 我 们 现在 要 设置 属性 ,让 Datasource Bean 指 向 PostgreSQL ii 4E Ji 1) H2 Pg. s 
具体 来 说 ,我 们 要 设置 的 是 spring.datasource.url、spring.datasource.username 以 及 
spring.datasource.pas sword 属 性 。 

在 设置 这 些 内 容 时 ,我 在 本 地 运行 了 一 个 PostgreSQL 数 据 库 ， 监 听 5432 端 口 。 用 户 名 和 密码 
分 别 是 habuma 和 password。 因 此 ，application.yml 的 production Profile 里 需要 如 下 内 容 : 























spring: 

profiles: production 

datasource: 
url: jdbc:postgresql://localhost:5432/readinglist 
username: habuma 
password: password 

jpa: 
database-platform: org.hibernate.dialect.PostgreSQLDialect 


请 注意 ， 这 个 代码 片段 以 --- 开 头 ， 设 置 的 第 一 个 属性 是 spring.profiles。 这 说 明 随 后 
的 属性 都 只 在 productionProfile 激 活 时 才 会 生效 。 


随后 设置 的 是 spring.datasource.url、spring.datasource.username 和 spring. 





ni 























= Lo Lxx F ; ES 
datasource.password 属 性 。 注意，spring.datasource.driver-class-name 属 性 一 般 无 


需 设置 。Spring Boot 可 以 根据 spring.aatasource.utr1 属 性 的 值 做 出 相应 推 上 新 。 我 还 设置 了 一 
些 JPA 的 属性 。spring.jpa.database-platform 属 性 将 底层 的 JPA 引 擎 设置 为 Hibernate 的 
PostgreSQL77 ri o 


























ni 
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要 开启 这 个 Profile, 我 们 需要 把 spring .profiles.active 属 性 设置 为 production。 实现 
方式 有 很 多 , 但 最 方便 的 还 是 在 运行 应 用 服务 器 的 机 器 上 设置 一 个 系统 环境 变量 。 在 启动 Tomcat 
前 开启 productionProfile， 我 需要 像 这 样 设置 SPRING_PROFILES_ACTIVE 环 境 变量 : 








$ export SPRING PROFILES ACTIVE-production 


f yAVEELZSTEXESI T , SPRING. PROFILES, ACTIVEAIR] T spring.profiles.activee 
为 无 法 在 环境 变量 名 里 使 用 句点 ， 所 以 变量 名 需要 稍 作 修改 。 站 在 Spring 的 角度 看 ， 这 两 个 名 字 
是 等 价 的 。 

我 们 基本 已 经 可 以 在 应 用 服务 器 上 部 署 并 运行 应 用 程序 了 。 实际 上 ， 如果 你 喜欢 冒险 ,也 可 
以 直接 尝试 一 下 。 不 过 你 会 遇 到 一 点 小 问题 。 

默认 情况 下 ， 在 使 用 内 骨 的 H2 数 据 库 时 ，Spring Boot 会 配置 Hibernate 来 自动 创建 Schema。 
更 确切 地 说 ， 这 是 将 Hibernate 的 hibernate.hbm2dql .auto 设 置 为 create-dqrop ， 说 明 在 
Hibernate 的 sessionFactory 创 建 时 会 创建 Schema，sessionFactory 关 闭 时 删除 Schema。 

但 如 果 没 使 用 内 髋 的 H2 数 据 库 ， 那 么 它 什 么 都 不 会 做 。 也 就 是 ， 说 应 用 程序 的 数据 表 尚 不 
存在 ， 在 查询 那些 不 存在 的 表 时 会 报错 。 


8.2.3 ”开启 数据 库 迁 移 


一 种 途径 是 通过 Spring Boot 的 spring.jpa.hibernate.ddl-auto 属 性 将 hibernate. 
hbm2dd1 .auto 属 性 设置 为 create、create-drop 或 update。 例如, 要 把 hibernate.hbm2dd]l. 
auto 设 置 为 create-drop， 我 们 可 以 在 application.yml 里 加 入 如 下 内 容 : 




































































spring: 
jpa: 
hibernate: 
ddl-auto: create-drop 


然而 , 这 对 生产 环境 来 说 并 不 理想 ,因为 应 用 程序 每 次 重启 数据 库 ，Schema 就 会 被 清空 ， 从 
头 开始 重建 。 它 可 以 设置 为 updaate， 但 就 算 这 样 ， 我 们 也 不 建议 将 其 用 于 生产 环境 。 

还 有 一 个 途径 。 我 们 可 以 在 schema.sql 里 定义 Schema。 在 第 一 次 运行 时 ， 这 么 做 没有 问题 ， 
但 随后 每 次 启动 应 用 程序 时 ， 这 个 初始 化 脚本 都 会 失败 ， 因 为 数据 表 已 经 存在 了 。 这 就 要 求 在 书 
写 初始 化 脚本 时 格外 注意 ， 不 要 重复 执行 那些 已 经 做 过 的 工作 。 

一 个 比较 好 的 选择 是 使 用 数据 库 迁 移 库 ( database migration library )。 它 使 用 一 系列 数据 库 脚 
本 ， 而 且 会 记录 哪些 已 经 用 过 了 , 不 会 多 次 运用 同一 个 脚本 。 应 用 程序 的 每 个 部 署 包 里 都 包含 了 
这 些 脚本 ， 数 据 库 可 以 和 应 用 程序 保持 一 致 。 

Spring Boot 为 两 款 流 行 的 数据 库 迁 移 库 提供 了 自动 配置 支持 。 
Q Flyway ( http://flywaydb.org ) 
D Liquibase ( http://www.liquibase.org ) 
当 你 想 要 在 Spring Boot 里 使 用 其 中 某 一 个 库 时 ， 只 需 在 项 目 里 加 入 对 应 的 依赖 ， 然 后 编写 脚 NN 
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本 就 可 以 了 。 让 我 们 先 从 Flyway 开 始 了 解 吧 。 

1. 用 Flyway 定 义 数据 库 迁 移 过 程 

Flyway 是 一 个 非常 简单 的 开源 数据 库 迁 移 库 ， 使 用 SQL 来 定义 迁移 脚本 。 它 的 理念 是 ， 每 个 
脚本 都 有 一 个 版 本 号 ，Flyway 会 顺序 执行 这 些 脚本 ,让 数据 库 达 到 期 望 的 状态 。 它 也 会 记录 已 执 
行 的 脚本 状态 ， 不 会 重复 执行 。 

在 阅读 列表 应 用 程序 这 里 , 我们 先 从 一 个 没有 数据 表 和 数据 的 空 数据 库 开 始 。 因 此 ,这 个 脚 
本 里 需要 先 创 建 Reader 和 Book 表 , 包含 外 键 约 束 和 初始 化 数据 。 代 码 清单 8-2 就 是 从 空 数 据 库 到 
可 用 状态 的 Flyway 脚 本 。 


代码 清单 8-2 ”Flyway 数 据 库 初 始 脚本 


create table Reader ( <1 
id serial primary key, 创建 Reader 表 
username varchar(25) unique not null, 
password varchar(25) not null, 
fullname varchar(50) not null 
ys: 
































create table Book ( «L— — — 创建 Book 表 
id serial primary key, 
author varchar(50) not null, 
description varchar(1000) not null, 
isbn varchar(10) not null, 
title varchar(250) not null, 
reader username varchar(25) not null, 
foreign key (reader username) references Reader (username) 


a 


create sequence hibernate_sequence; «— 定义 序列 
insert into Reader (username, password, fullname) < Reader 的 初始 
values ('craig', 'password', 'Craig Walls'); 数据 


如 你 所 见 , Flyway 脚 本 就 是 SQL。 让 其 发 挥 作 用 的 是 其 在 Classpath 里 的 位 置 和 文件 名 。Flyway 
脚本 都 遵循 一 个 命名 规范 ， 含 有 版 本 号 ， 具 体 如 图 8-1 所 示 。 
版 本 描述 


b 


V2 initialize.sqgl 











(2 个 下 划 线 ) 


图 8-1 用 版 本 号 命名 的 Flyway 脚 本 
所 有 Flyway 脚 本 的 名 字 都 以 大 写字 母 V 开 头 ， 随 后 是 脚本 的 版 本 号 。 后 面 跟着 两 个 下 划 线 和 
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对 脚本 的 描述 。 因 为 这 是 整个 迁移 过 程 中 的 第 一 个 脚本 ， 所 以 它 的 版 本 是 1。 描 述 可 以 很 灵活 ， 
主要 用 来 帮助 理解 脚本 的 用 途 , 稍 后 我 们 需要 向 数据 库 添加 新 表 , 或 者 向 已 有 数据 表 添加 新 字段 。 
可 以 再 创建 一 个 脚本 ,标明 版 本 号 为 2。 

Flyway 脚 本 需要 放 在 相对 于 应 用 程序 Classpath 根 路 径 的 /dbimigration 路 径 下 。 因 此 ,项 目 中 ， 
脚本 需要 放 在 src/main/resources/db/migration 里 。 

你 还 需要 将 spring .jpa.hibernate.ddl-auto 设 置 为 none， 由 此 告知 Hibernate 不 要 创建 
数据 表 。 这 关系 到 application.yml 中 的 如 下 内 容 : 

spring: 

jpa: 
hibernate: 
ddl-auto: none 


剩 下 的 就 是 将 Flyway 添 加 为 项 目 依 赖 。 在 Gradle 里 ， 此 依赖 是 这 样 的 : 
compile("org.flywaydb:flyway-core") 


在 Maven 项 目 里 ，<dependency> 是 这 样 的 : 





























<dependency> 
«groupId»org.flywayfb«/grouplId» 
«artifactId»flyway-core«/artifactId» 
«/dependency» 


在 应 用 程序 部 署 并 运行 起 来 后 ，Spring Boot 会 检测 到 Classpath 里 的 Flyway， 自 动 配置 所 需 的 
Bean。Flyway 会 依次 查看 /db/migration 里 的 脚本 ， 如 果 没 有 执行 过 就 运行 这 些 脚 本 。 每 个 脚本 都 
执行 过 后 ,向 schema_version 表 里 写 一 条 记录 。 应 用 程序 下 次 启动 时 ,Flyway 会 先 看 schema_version 
里 的 记录 ， 跳 过 那些 脚本 。 

2. 用 Liquibase 定 义 数 据 库 迁 移 过 程 

Flyway 用 起 来 很 简便 ， 在 Spring Boot 自 动 配置 的 帮助 下 尤其 如 此 。 但 是 ， 使 用 SQL 来 定义 迁 
移 脚本 是 一 把 双 丸 剑 。SQL 用 起 来 便捷 顺手 ， 却 要 冒 着 只 能 在 一 个 数据 库 平台 上 使 用 的 风险 。 

Liquibase 并 不 局 限于 特定 平台 的 SQL, 可 以 用 多 种 格式 书写 迁移 脚本 ,不 用 关心 底层 平台 ( 其 
中 包括 XML、YAML 和 JSON )。 如 果 你 有 这 个 期 望 的 话 ，Liquibase 当 然 也 支持 SQL 脚本 。 

要 在 Spring Boot 里 使 用 Liquibase， 第 一 步 是 添加 依赖 。Gradle 里 的 依赖 是 这 样 的 : 


compile("org.liquibase:liquibase-core") 


对 于 Maven 项 目 ， 你 需要 添加 如 下 <dependency>: 



























































<dependency> 
<groupId>org.liquibase</groupId> 
<artifactId>liquibase-core</artifactId> 
</dependency> 


有 了 这 个 依赖 ，Spring Boot 自 动 配置 就 能 接手 ， 配 置 好 用 于 支持 Liquibase 的 Bean。 默 认 情 况 
下 ， 那 些 Bean 会 在 /db/changelog( 相对 于 Classpath 根 目录 ) 里 查找 db.changelog-master.yaml 文 件 。 
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这 个 文件 里 都 是 迁移 脚本 。 代码 清单 8-3 的 初始 化 脚本 为 阅读 列表 应 用 程序 进行 了 数据 库 初 始 化 。 
代码 清单 8-3 ”用 于 阅读 列表 数据 库 的 Liquibase 初 始 化 脚本 


databaseChangeLog: 
- changeSet: 
id: 1 < 一 一 变更 集 ID 
author: habuma 
changes: 
- createTable: 
tableName: reader < 一 
columns : 创建 reader 表 
- column: 
name: username 
type: varchar (25) 
constraints: 
unique: true 
nullable: false 
- column: 
name: password 
type: varchar (25) 
constraints: 
nullable: false 
- column: 
name: fullname 
type: varchar(50) 
constraints: 
nullable: false 
- createTable: 
tableName: book «jL-———— 
columns: 创建 book 表 
- column: 
name: id 
type: bigserial 
autoIncrement: true 
constraints: 
primaryKey: true 
nullable: false 
- column: 
name: author 
type: varchar(50) 
constraints: 
nullable: false 
- column: 
name: description 
type: varchar(1000) 
constraints: 
nullable: false 
- column: 
name: isbn 
type: varchar (10) 
constraints: 
nullable: false 
- column: 
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name: title 
type: varchar (250) 
constraints: 
nullable: false 
- column: 
name: reader username 
type: varchar (25) 
constraints: 
nullable: false 
references: reader(username) 
foreignKeyName: fk reader username 


- createSequence: q 

sequenceName: hibernate_sequence 定义 序列 
- insert: 

tableName: reader < 一 : 

NC 插入 reader 的 初 

u : 、 
始 记录 
- column: 


name: username 
value: craig 

- column: 
name: password 
value: password 

- column: 
name: fullname 
value: Craig Walls 


如 你 所 见 ， 比 起 等 效 的 Flyway SQL 脚本 ，YAML 格 式 略 显 繁琐 ， 但 看 起 来 还 是 很 清晰 的 ， 而 
且 这 个 脚本 不 与 任何 特定 的 数据 库 平台 绑 定 。 

与 Flyway 不 同 ，Flyway 有 多 个 脚本 ， 每 个 脚本 对 应 一 个 变更 集 。Liquibase 变 更 集 都 集中 在 一 
个 文件 里 。 请 注意 ，changeset 命 令 后 的 那 行 有 一 个 ia 属 性 ， 要 对 数据 库 进 行 后 续 变更 。 可 以 
添加 一 个 新 的 changeset ， 只 要 id 不 一 样 就 行 。 此 外 ，iq 属 性 也 不 一 定 是 数字 ， 可 以 包含 任意 
内 容 。 

应 用 程序 启动 时 ，Liquibase 会 读 取 db.changelog-masteryaml 里 的 变更 集 指 令 集 ， 与 之 前 写 人 
databasechangeLog 表 里 的 内 容 做 对 比 ， 随 后 执行 未 运行 过 的 变更 集 。 

虽然 这 里 的 例子 使 用 的 是 YAML 格 式 , 但 你 也 可 以 任意 选择 Liquibase 所 支持 的 其 他 格式 ， 比 
如 XML 或 JION 。 只 需 简单 地 设置 1iquibase.change-log 属 性 (在 application.properties 或 
application.yml 里 )， 标 明和 希望 Liquibase 加 载 的 文件 即 可 。 举 个 例子 ， 要 使 用 XML 变更 集 ， 可 以 这 
样 设置 1iquibase.change-1log: 











































































































liquibase: 
change-log: classpath:/db/changelog/db.changelog-master.xml 


Spring Boot 的 自动 配置 让 Liquibase 和 Flyway 的 使 用 变 得 轻而易举 。 但 实际 上 所 有 数据 库 迁 移 
库 都 有 更 多 功能 ， 这 里 不 便 一 一 列举 。 建 议 大 家 参考 官方 文档 ， 了 人 解 更 多 详细 内 容 。 

我 们 已 经 了 解 了 如 何 将 Spring Boot 应 用 程序 部 署 到 传统 的 Java 应 用 服务 器 上 ， 基 本 就 是 创建 
一 个 springBootServletInitializer 的 子 类 , 调整 构建 说 明 来 生成 一 个 WAR 文 件 , 而 非 JAR 
文件 。 接 下 来 我 们 会 看 到 ，Spring Boot 应 用 程序 在 云端 使 用 更 方便 。 
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8.8 推 上 云端 


服务 器 硬件 的 购买 和 维护 成 本 很 高 。 大 流量 很 难 通过 适当 扩展 服务 器 去 处 理 , 这 种 做 法 在 某 
些 组 织 中 甚至 是 禁忌 。 现 如 今 , 相 比 在 自己 的 数据 中 心 运行 应 用 程序 ,把 它们 部 署 到 云 上 是 更 引 
人 注目 ， 而 且 划 算 的 做 法 。 

目前 有 多 个 云 平台 可 供 选 择 ， 而 那些 提供 Platform as a Service ( PaaS ) 能 力 的 平台 无 疑 是 最 
有 吸引 力 的 。PaaS 提 供 了 现成 的 应 用 程序 部 署 平台 ， 带 有 附加 服务 C 比如 数据 库 和 消息 代理 )， 
可 以 绑 定 到 应 用 程序 上 。 除 此 之 外 ， 当 你 的 应 用 程序 要 求 提供 更 大 的 马力 时 ， 云 平台 能 轻松 实现 
应 用 程序 在 运行 时 向 上 (或 向 下 ) 伸缩 ， 只 需 添 加 或 删除 实例 即 可 。 

之 前 我 们 已 经 把 阅读 列表 应 用 程序 部 署 到 了 传统 的 应 用 服务 器 上 , 现在 再 试 试 将 其 部 署 到 云 
上 。 我 们 将 把 应 用 程序 部 署 到 Cloud Foundry 和 Heroku 这 两 个 著名 的 PaaS 平 台 上 。 













































































8.3.1 部署 到 Cloud Foundry 








Cloud Foundry 是 Pivotal 的 PaaS 平 台 。 这 家 公司 也 赞助 了 Spring Framework 和 Spring 平台 里 的 其 
他 库 。Cloud Foundry 里 最 吸引 人 的 特点 之 一 就 是 它 既 有 开源 版 本 , 也 有 多 个 商业 版 本 。 你 可 以 选 
择 在 何 处 运行 Cloud Foundry。 它 甚至 还 可 以 在 公司 数据 中 心 的 防火 墙 后 运行 ， 提 供 私有 云 。 

我 打算 将 阅读 列表 应 用 程序 部 署 到 Pivotal Web Services (PWS ) 上 。 这 是 一 个 由 Pivotal 托 管 
的 公共 Cloud Foundry， 地 址 是 http:/run.pivotalio。 如 果 想 使 用 PWS， 你 可 以 注册 一 个 账号 。PWS 
提供 为 期 60 天 的 免费 试用 ， 在 试用 期 间 无 需 提 交 任 何 信用 卡 信息 。 

在 注册 了 PWS 后 ， 可 以 从 https://console.run.pivotal.io/tools 下 载 并 安装 cf 命令 行 工 具 。 你 可 以 
通过 这 个 工具 将 应 用 程序 推 上 Cloud Foundry。 但 你 要 先 用 这 个 工具 登录 自己 的 PWS 账 号 。 









































$ cf login -a https://api.run.pivotal.io 
API endpoint: https://api.run.pivotal.io 


Email» (your email) 
Password» (your password) 


Authenticating... 
OK 











现在 我 们 已 经 可 以 把 阅读 列表 应 用 程序 传 到 云 上 了 。 实际 上 , 我 们 的 项 目 已 经 做 好 了 部 署 到 
Cloud Foundry 的 准备 ， 只 需 使 用 cf push 命 令 把 它 推 上 去 就 好 。 


$ cf push sbia-readinglist -p build/libs/readinglist.war 


cf push 命 令 的 第 一 个 参数 指定 了 应 用 程序 在 Cloud Foundry 里 的 名 称 。 这 个 名 称 将 被 用 作 托 
管 应 用 程序 的 子 域名 。 本 例 中 ， 应 用 程序 的 完整 域名 将 是 http://sbia-readinglist.cfapps.io。 因 此 ， 
应 用 程序 的 命名 很 重要 。 名 字 必 须 独 一 无 二 , 这 样 才 不 会 和 Cloud Foundry 里 部 署 的 其 他 应 用 程序 
(包括 其 他 用 户 部 署 的 应 用 程序 ) 发 生 冲 突 。 

因为 空想 一 个 独一无二 的 名 称 有 点 困难 ， 所 以 cf push 命 令 提 供 了 一 个 --random-route 
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选项 ,可 以 为 你 随机 产生 一 个 子 域名 。 下 面 的 例子 演示 了 如 何 上 传阅 读 列表 应 用 程序 ， 生 成 一 个 
随机 的 子 域名 。 


$ cf push sbia-readinglist -p build/libs/readinglist.war --random-route 


在 使 用 了 - -random-route/H, 还 是 要 设 定 应 用 程序 名 称 。 会 有 两 个 随机 选择 的 单词 添加 到 
后 面 ， 组 成 子 域名 。( 在 我 自己 尝试 的 时 候 ， 生 成 的 子 域名 是 sbia-readinglist-gastroenterological- 


stethoscope。 ) 


不 仅仅 是 WAR 文 件 ”虽然 我 们 部 署 的 应 用 程序 是 一 个 WAR 文 件 ， 但 Cloud Foundry 
也 可 以 部 署 其 他 格式 的 Spring Boot 应 用 程序 ， 包 括 可 执行 的 JAR 文 件 ， 甚 至 Spring Boot 
CLI 开 发 的 未 经 编译 的 Groovy 脚 本 。 


如 果 一 切 顺 利 , 我 们 部 署 的 应 用 程序 应 该 可 以 处 理 请 求 了 。 假设 子 域 名 是 sbia-readinglist， 你 
可 以 用 浏览 器 访问 http://sbia-readinglist.cfapps.io， 看 看 效果 。 你 应 该 会 被 引导 到 登录 页 。 回 想 一 
下 ， 数 据 库 迁 移 脚 本 中 插入 了 一 个 名 为 craig 的 用 户 ， 密 码 是 password， 可 以 以 此 登录 应 用 程序 。 

你 可 以 在 应 用 程序 里 随便 点 点 ,加 几 本 书 。 所 有 的 东西 都 可 以 运行 , 但 还 是 有 点 不 对 劲 。 如 
果 重 启 应 用 程序 (通过 cf restart 命 令 )， 重 新 登录 ， 你 会 发 现 阅读 列表 清空 了 。 你 在 重启 前 
添加 的 书 都 不 见 了 。 

应 用 程序 重启 后 数据 消失 ,原因 在 于 我 们 还 在 使 用 内 骸 的 H2 数 据 库 。 我 们 可 以 通过 Actuator 













































































的 /health 端 点 验证 推测 。 它 返回 的 信息 大 约 是 这 样 的 : 
{ 
"status": "UP", 
"diskSpace": ( 
"status": "UP", 


"free": 834236510208, 
"threshold": 10485760 
} 
"db": { 
"Statug'*s MUB'; 
"database": "H2", 
"hello": 1 
} 
} 
请 注意 qb .database 属 性 的 值 。 它 证 实 了 我 们 之 前 的 怀疑 
我 们 需要 修复 这 个 问题 。 
实际 上 ，Cloud Foundry 以 市 集 服务 ( marketplace services ) 的 形式 提供 了 一 些 数据 库 以 供 选 
TÉ, 包括 MySQL 和 PostgreSQL。 因 为 我 们 已 经 在 项 目 里 放 了 PostgreSQL 的 JDBC 了 驱动， 所 以 就 使 
用 市 集 里 的 PostgreSQL 服 务 ， 名 字 是 elephantsql。 
elephantsql 服 务 也 有 不 少 计划 可 选 ， 小 到 开发 用 的 小 型 数据 库 ， 大 到 工业 级 生产 数据 库 。 
elephantsql 的 完整 计划 列表 可 以 通过 cf marketplace 命 令 获 得 。 
$ cf marketplace -s elephantsql 
Getting service plan information for service elephantsqgl as craigGhabuma.com... 
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OK 

Service plan description free or paid 
turtle Tiny Turtle free 

panda Pretty Panda paid 

hippo Happy Hippo paid 
elephant Enormous Elephant paid 


如 你 所 见 ， 比 较 严 并 的 生产 级 数据 库 计 划 都 是 要 付费 的 。 你 可 以 选择 你 所 期 望 的 计划 。 我 先 
假设 你 会 选择 免费 的 turtle。 

创建 数据 库 服务 的 实例 ， 需 要 使 用 cf create-service S, 指定 服务 名 、 计 划 名 和 实 
例 名 。 


$ cf create-service elephantsql turtle readinglistdb 
Creating service readinglistdb in org habuma / 
space development as craigQ8habuma.com... 














OK 

服务 创建 后 ， 需 要 通过 cf bindq-service 命 令 将 它 绑 定 到 我 们 的 应 用 程序 上 。 

$ cf bind-service sbia-readinglist readinglistdb 

将 一 个 服务 绑 定 到 应 用 程序 上 不 过 就 是 为 应 用 程序 提供 了 连接 服务 的 细节 , 这 里 用 的 是 名 为 
VCAP_SERVICES 的 环境 变量 。 它 不 会 通过 修改 应 用 程序 来 使 用 服务 。 

我 们 可 以 改写 阅读 列表 应 用 程序 ， 读 取 vcaP_SsERVvICES， 使 用 其 中 提供 的 信息 来 连接 数据 
库 服务 。 但 其 实 完全 不 用 这 么 做 。 实 际 上 , 我 们 只 需 用 cf restage 命 令 重 启 应 用 程序 就 可 以 了 : 

$ cf restage sbia-readinglist 

cf restage 命 令 会 让 Cloud Foundry 重 新 部 署 应 用 程序 ， 并 重新 计算 vcAP_sERVICES 的 值 。 
如 此 一 来 ,我 们 的 应 用 程序 会 在 Spring 应 用 程序 上 下 文 里 声明 一 个 引用 了 绑 定数 据 库 服 务 的 
DataSource Bean, HEX MIX HJ DataSource Bean。 这 样 我 们 就 能 抛 开 内 舱 的 H2 数 据 库 ， 
使 用 elephantsql 提 供 的 PostgreSQL 服 务 了 。 

现在 来 试 一 下 。 登 录 应 用 程序 ， 添 加 几 本 书 ， 然 后 重启 。 重 启 之 后 你 所 添加 的 书 应 该 还 在 列 
表 里 ， 因 为 它们 已 经 被 持久 化 在 绑 定 的 数据 库 服务 里 ， 而 非 内 内 的 H2 数 据 库 里 。 再 访问 一 下 
Actuator 的 /health 端 点 ， 返 回 的 内 容 能 证 明 我 们 在 使 用 PostgreSQL : 


( 





































































































"status". "Up", 
"diskSpace": ( 
"Status... 


"free": 834331525120, 
"threshold": 10485760 
Y 
"apta Y 
"status": "UP", 
"database": "PostgreSQL", 
"hello": 1 
j 
} 
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Cloud Foundry 对 Spring Boot 应 用 程序 部 署 而 言 是 极 佳 的 PaaS Cloud Foundry 与 Spring 项 目 搭 
配 可 谓 如 虎 添 翼 。 但 Cloud Foundry 并 非 Spring Boot 应 用 程序 在 PaaSs 方 面 的 唯一 选择 。 让 我 们 来 看 
看 如 何 将 阅读 列表 应 用 程序 部 署 到 另 一 个 流行 的 Paas 平 台 : Heroku。 

















8.3.2 部 署 到 Heroku 


Heroku 在 应 用 程序 部 署 上 有 一 套 独 特 的 方法 , 不 用 部 署 完整 的 部 署 产 物 。Heroku 为 你 的 应 用 
程序 安排 了 一 个 Git 仓 库 。 每 当 你 向 仓库 里 提交 代码 时 ， 它 都 会 自动 为 你 构建 并 部 署 应 用 程序 。 

如 果 还 是 解决 不 了 问题 ， 则 需要 先 将 项 目 目录 初始 化 为 Git 仓 库 。 

$ git init 

这 样 Heroku 的 命令 行 工 具 就 能 自动 把 远程 Heroku Git 仓 库 添 加 到 项 目 里 。 

现在 可 以 通过 Heroku 的 命令 行 工 具 在 Heroku 中 设置 应 用 程序 了 。 这 里 使 用 apps :create 命令 。 

$ heroku apps:create sbia-readinglist 

这 里 我 要 求 Heroku 将 应 用 程序 命名 为 sbia-readinglist。 这 将 成 为 Git 仓 库 的 名 字 ， 同 时 也 是 应 
用 程序 在 herokuapps.com 的 子 域名 。 你 需要 确定 这 个 名 字 唯 一 ,因为 不 能 有 同名 应 用 程序 。 此 外 ， 
也 可 以 让 Heroku 替 你 生成 一 个 独特 的 名 字 ( 比如 fierce-river-8120 或 serene-anchorage-6223 )。 

apps :create 命 令 会 在 https://git.heroku.com/sbia-readinglist.git 创 建 一 个 远程 Git 仓 库 , 并 在 本 
地 项 目的 Git 配 置 里 添加 一 个 名 为 heroku 的 远程 仓库 引用 。 这 样 就 能 通过 git 命 令 将 项 目 推送 到 
Heroku f 。 

Heroku 里 的 项 目 已 经 设置 完毕 ， 但 我 们 现在 还 不 能 进行 推送 。Heroku 需 要 你 提供 一 个 名 为 
Procfile 的 文件 , 告诉 Heroku 应 用 程序 构建 后 该 如 何 运行 。 对 于 阅读 列表 应 用 程序 而 言 , 我 们 需要 
告诉 Heroku， 构 建生 成 的 WAR 文 件 要 当 作 可 执行 JAR 文 件 来 运行 ， 这 里 使 用 java 命 令 。 "假设 应 
用 程序 是 用 Gradle 来 构建 的 ， 只 需要 如 下 一 行内 容 的 Procfile: 


web: java -Dserver.port=$PORT -jar build/libs/readinglist.war 


另 一 方面 , 如 果 你 使 用 Maven 来 构建 项 目 ,JAR 文 件 的 路 径 就 会 有 所 不 同 。Heroku 需 要 到 target 
目录 ， 而 不 是 build/libs 目 录 里 寻找 可 执行 WAR 文 件 。 具 体 如 下 : 


web: java -Dserver.port-$PORT -jar target/readinglist.war 


不 管 何 种 情况 ， 你 都 需要 像 例 子 中 那样 设置 server .port 属 性 。 这 样 内 能 的 Tomcat 服 务 需 
才能 在 Heroku 分 配 的 端口 上 (通过 $PORT 变 量 指定 ) 启动 。 

我 们 差不多 可 以 把 应 用 程序 推 上 Heroku 了， 但 Gradle 构 建 说 明 还 要 稍 作 调整 。Heroku 构 建 应 
用 程序 时 ， 会 执行 一 个 名 为 stage 的 任务 ， 因 此 需要 在 build.gradle 里 添加 这 个 stage 任 务 。 


task stage(dependsOn: ['build']) ( 
} 














































































































4 























CD 当前 使 用 的 项 目 会 实际 生成 一 个 可 执行 的 WAR 文 件 。 但 对 Heroku 来 说 ， 它 和 可 执行 的 JAR 文 件 没什么 区 别 。 
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如 你 所 见 ， 这 个 stage 任 务 什么 也 没 做 ， 但 依赖 了 build 任 务 。 于 是 ， 在 Heroku 使 用 stage 
任务 构建 应 用 程序 会 触发 build 任 务 ， 生 成 的 JAR 文 件 会 放 在 build/libs 目 录 里 。 

你 还 需要 告诉 Heroku 用 什么 Java 版 本 来 构建 并 运行 应 用 程序 。 这 样 Heroku 才 能 用 合适 的 版 本 
来 运行 它 。 最 简单 的 方法 是 在 项 目 根 目录 里 创 一 个 名 为 system.properties 的 文件 ， 在 其 中 设置 


java.runtime.version 属 性 : 














java.runtime.version=1.7 
现在 就 可 以 将 项 目 推 EHeroku 了 。 和 前 面 说 一 样 ， 只 需 将 代码 推 到 远程 Git 仓 库 ，Heroku 会 
帮 有 我 们 搞定 其 他 事情 。 


$ git commit -am "Initial commit" 
$ git push heroku master 


然后 ，Heroku 会 根据 找到 的 构建 说 明文 件 ， 使 用 Maven 或 Gradle 进 行 构建 ， 再 用 Procfile 
里 的 指令 来 运行 应 用 程序 。 就 绪 后 ， 你 可 以 用 浏览 器 打开 http://{app name}.herokuapp.com， 这 里 
If] (app name} 就 是 你 在 apps :create 里 给 应 用 程序 起 的 名 字 。 例如 , 我 在 部 署 时 将 应 用 程序 命名 
为 sbia-readinglist， 所 以 它 的 URL 就 是 http://sbia-readinglist. herokuapps.com。 

你 可 以 在 应 用 程序 里 随便 点 点 , 但 要 访问 一 下 /health 端 点 。db .database 属 性 会 告诉 你 应 用 
程序 正在 使 用 内 赂 的 H2 数 据 库 。 我 们 应 该 把 它 换 成 PostgreSQL 服 务 。 

我 们 可 以 通过 Heroku 命 令 行 工 具 的 addons :adq 命 令 创 建 并 绑 定 一 个 PostgreSQL 服 务 。 













































































$ heroku addons:add heroku-postgresql:hobby-dev 


这 里 我 们 要 使 用 名 为 heroku-postgresql 的 附加 服务 。 这 是 Heroku 提 供 的 PostgreSQL 服 务 。 
我 们 还 要 求 使 用 该 服务 的 hobby-dev 计 划 ， 这 是 免费 的 。 

在 PostgreSQL 服 务 创建 并 绑 定 到 应 用 程序 后 ，Heroku 会 自动 重启 应 用 程序 以 保证 绑 定 生效 。 
但 即便 如 此 , 我 们 在 访问 /health 端 点 时 仍然 会 看 到 应 用 程序 还 在 使 用 内 舱 的 H2 数 据 库 。 那 是 因为 
H2 的 自动 配置 仍然 有 效 ， 谁 也 没 告诉 Spring Boot 要 用 PostgreSQL 代 替 H2 。 

一 个 办 法 是 设置 spring .datasource.* 属 性 , 做 法 和 我 们 将 应 用 程序 部 署 到 应 用 服务 器 上 
时 一 样 。 我 们 所 需要 的 信息 能 在 数据 库 服务 的 仪表 板 上 找到 ， 可 以 用 aqaaons :open 命 令 打开 仪 
表 板 。 

$ heroku addons:open waking-carefully-3728 

在 这 个 例子 里 , 数据 库 实例 的 名 字 是 waking-carefully-3728。 该 命令 会 在 Web 浏 览 器 里 打开 仪 
表 板 页 面 ， 其 中 包含 了 你 所 需要 的 全 部 连接 信息 ,包括 主机 名 、 数 据 库 名 和 账户 信息 。 总 之 , 设 
置 spring .datasource.* 属 性 所 需 的 一 切 信息 都 在 这 里 了 。 

还 有 一 个 更 简单 的 办 法 ， 与 其 自己 查找 那些 信息 ， 再 设置 到 属性 里 ， 为 什么 不 让 Spring 替 我 
们 查找 信息 呢 ? 实际 上 ， 这 就 是 Spring Cloud Connectors 的 用 途 。 它 可 以 用 在 Cloud Foundry 和 
Heroku 上， 查找 绑 定 到 应 用 程序 上 的 所 有 服务 ， 并 自动 配置 应 用 程序 ， 以 便 使 用 那些 服务 。 

我 们 只 需 在 项 目 中 加 入 Spring Cloud Connectors 依 赖 即 可 。 在 Gradle 项 目 里 ， 在 build.gradle 中 
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添加 如 下 内 容 : 


compile( 
"org.springframework.boot:spring-boot-starter-cloud-connectors") 


如 果 你 用 的 是 Maven， 则 添加 如 下 Spring Cloud Connectors-dependency:» : 





«dependency» 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-starter-cloud-connectors«/artifactId» 
</dependency> 


只 有 激活 cloud Profile, Spring Cloud Connectors 才 会 工作 。 要 在 Heroku 里 激活 cloud Profile, 
可 以 使 用 config:set 命 邻 : 


$ heroku config:set SPRING PROFILES ACTIVE-"cloud" 


MEH H EA T Spring Cloud Connectors 依 赖 ，cloud Profile 也 激活 了 。 我 们 可 以 再 推 一 次 应 
用 程序 。 


$ git commit -am "Add cloud connector" 
$ git push heroku master 


应 用 程序 启动 后 ， 登 入 应 用 程序 ， 查 看 /health 端 点 。 它 应 该 显示 应 用 程序 已 经 连接 到 了 
PostgreSQL 数 据 库 : 
"abs ti 
"status": "UP", 
"database": "PostgreSQL", 


"hello": 1 
} 


现在 我 们 的 应 用 程序 已 经 部 署 到 云 上 ， 可 以 接受 世界 各 地 的 请 求 了 ! 





























8.4 小 结 


Spring Boot 应 用 程序 的 部 署 方式 有 好 几 种 ， 包 括 使 用 传统 的 应 用 服务 器 和 云 上 的 PaaS 平 台 
在 本 章 , 我 们 了 解 了 其 中 的 一 些 部 署 方式 , 把 阅读 列表 应 用 程序 以 WAR 文 件 的 方式 部 署 到 Tomeat 
FZE (Cloud Foundry 和 Heroku )。 

Spring Boot 应 用 程序 的 构建 说 明 经 常会 配置 为 生成 可 执行 的 JAR 文 件 。 我 们 也 看 到 了 如 何 对 
构建 进行 微调 ， 如 何 编写 一 个 SpringBootSservletInitializer 实 现 ， 生 成 WAR 文 件 ， 以 便 
部 署 到 应 用 服务 器 上 。 

随后 ， 我 们 进一步 了 解 了 如 何 将 应 用 程序 部 署 到 Cloud Foundry 上 。Cloud Foundry 非 常 灵 活 ， 
能 够 接受 各 种 形式 的 Spring Boot 应 用 程序 ， 包 括 可 执行 JAR 文 件 、 传 统 WAR 文 件 ， 其 至 还 包括 原 
始 的 Spring Boot CLI Groovy 脚 本 。 我 们 还 了 解 了 Cloud Foundry thn A a V cx COR USER 2 A 
定 到 应 用 程序 上 的 数据 库 服务 。 

虽然 Heroku 不 能 像 Cloud Foundry 那 样 自 动 奉 换 数据 源 的 Bean, 但 在 本 章 最 后 , 我 们 还 是 看 到 






































156 第 8 章 AŽ Spring Boot 应 用 程序 





了 如 何 通 过 添加 Spring Cloud Foundry 库 来 实现 一 样 的 效果 。 这 里 使 用 绑 定 的 数据 库 服务 ， 而 非 内 
iro e o 

在 本 章 ， 我 们 还 了 解 了 如 何在 Spring Boot 里 使 用 Flyway 和 Liquibase 这 样 的 数据 库 迁 移 工具 。 
在 初次 部 署 应 用 程序 时 , 我 们 通过 数据 库 迁 移 的 方式 完成 了 数据 库 的 初始 化 , 在 后 续 的 部 署 过 程 
中 ， 我 们 可 以 按 需 修改 数据 库 。 

















Spring Boot 开 发 者 工具 











Spring Boot 1.3 引 入 了 一 组 新 的 开发 者 工具 ， 可 以 让 你 在 开发 时 更 方便 地 使 用 Spring Boot, 
包括 如 下 功能 。 
口 自动 重启 : 当 Classpath 里 的 文件 发 生变 化 时 ， 上 自动 重启 运行 中 的 应 用 程序 。 
口 LiveReload 支 持 : 对 资源 的 修改 自动 触发 浏览 器 刷新 。 
O 远程 开发 : 远程 部 署 时 支持 自动 重启 和 LiveReload。 
O 默认 的 开发 时 属性 值 ， 为 一些 属性 提供 有 意义 的 默认 开发 时 属性 值 。 

Spring Boot 的 开发 者 工具 采取 了 库 的 形式 ， 可 以 作为 依赖 加 入 项 目 。 如 果 你 使 用 Gradle 来 构 
建 项 目 ， 可 以 像 下面 这 样 在 build.gradle 文 件 里 添加 开发 工具 : 


compile "org.springframework.boot:spring-boot-devtools" 


在 Maven POM 里 添加 <dependency> 是 这 样 的 : 
































<dependency> 
«groupId»org.springframework.boot«/groupId» 
«artifactId»spring-boot-devtools«/artifactId» 
</dependency> 


当 应 用 程序 以 完整 打包 好 的 JAR 或 WAR 文 件 形式 运行 时 , 开发 者 工具 会 被 禁用 , 所 以 没有 必 
要 在 构建 生产 部 署 包 前 移 除 这 个 依赖 。 


A.1 自动 重启 


在 激活 了 开发 者 工具 后 ，Classpath 里 对 文件 做 任何 修改 都 会 触发 应 用 程序 重启 。 为 了 让 重启 
速度 够 快 ， 不 会 修改 的 类 C 比如 第 三 方 JAR 文 件 里 的 类 ) 都 加 载 到 了 基础 类 加 载 器 里 ， 而 应 用 程 
序 的 代码 则 会 加 载 到 一 个 单独 的 重启 类 加 载 器 里 。 检 测 到 变更 时 ， 只 有 重启 类 加 载 器 重启 。 

有 些 Classpath 里 的 资源 变更 后 不 需要 重启 应 用 程序 。 像 Thymeleaf 这 样 的 视图 模板 可 以 直接 
编辑 ,不 用 重启 应 用 程序 。 在 /static 或 /public 里 的 静态 资源 也 不 用 重启 应 用 程序 ,所 以 Spring Boot 
开发 者 工具 会 在 重启 时 排除 掉 如 下 目录 : /META-INF/resources , /resources, 、/static 、/public 和 
/templates。 


可 以 设置 spring .devtools.restart.exc ludqe 属 性 来 覆盖 默认 的 重启 排除 目录 。 例如 
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你 只 排除 /static 和 /templates 目 录 ， 可 以 像 这 样 设置 spring .devtools.restart. exclude: 





spring: 
devtools: 
restart: 
exclude: /static/**,/templates/** 


男 一 方面 ， 如 果 想 彻底 关闭 自动 重启 ， 可 以 将 spring .devtools.restart .enabled 设 置 
为 false: 





spring: 
devtools: 
restart: 
enabled: false 


另外 , 还 可 以 设置 一 个 触发 文件 , 必须 修改 这 个 文件 才能 触发 重启 。 例如, 在 修改 名 为 .trigger 
的 文件 前 你 都 不 希望 执行 重启 ， 那 么 你 只 需 像 这 样 设置 spring.devtools.restart.trigger- 
file 属 性 : 











spring: 
devtools: 
restart: 
trigger-file: .trigger 


如 果 你 的 IDE 会 连续 编译 修改 的 文件 ， 那 触发 文件 还 是 很 有 用 的 。 没 有 触发 文件 的 话 ， 每 次 
变更 都 会 触发 重启 。 有 触发 文件 ， 就 能 保证 只 有 你 想 重启 时 才 会 发 生 重启 〈 修改 触发 文件 即 可 )。 











A.2 LiveReload 


在 Web 应 用 程序 开发 过 程 中 ， 最 常见 的 步 又 大 致 如 下 。 

(1) 修改 要 呈现 的 内 容 ( 比如 图 片 、 样 式 表 、 模 板 )。 

(2) 点 击 浏览 絮 里 的 刷新 按钮 ， 查 看 修改 的 结 

(3) 回 到 第 1 步 。 

虽然 这 并 不 难 ， 但 如 果 能 不 点 刷新 就 直接 看 到 修改 结果 ， 那 岂 不 是 更 好 ? 

Spring Boot 的 开发 者 工具 集成 了 LiveReload (http:Wlivereload.com )， 可 以 消除 刷新 的 步骤 。 
激活 开发 者 工具 后 ，Spring Boot 会 启动 一 个 内 舱 的 LiveReload 服 务 器 ， 在 资源 文件 变化 时 会 触发 
浏览 器 刷新 。 你 要 做 的 就 是 在 浏览 器 里 安装 LiveReload 插 件 。 

如 果 想 要 禁用 内 和 瞬 的 LiveReload 服 务 需 ， 可 以 将 spring.aqevtools.livereload. 
enabled 设 置 为 false: 

spring: 

devtools: 


livereload: 
enabled: false 
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A.3 远程 开发 


在 远程 运行 应 用 程序 时 ( 比如 部 署 到 服务 器 上 或 云 上 ), 开发 者 工具 的 自动 重启 和 LiveReload 
特性 都 是 可 选 的 。 此 外 ，Spring Boot 开 发 者 工具 还 能 远程 调试 Spring Boot 应 用 程序 。 

在 传统 的 开发 过 程 中 ,你 不 会 打开 远程 开发 功能 ， 因 为 这 会 影响 性 能 。 但 在 一 些 特殊 的 场景 
中 ， 此 类 工具 就 很 有 用 。 比 如 ， 出 于 开发 目的 ， 所 开发 的 应 用 程序 部 署 在 非 生产 环境 里 。 如 果 应 
用 程序 不 是 在 本 地 开发 环境 里 ， 而 是 在 云端 部 署 ， 则 尤其 如 此 。 

你 必须 设置 一 个 远程 安全 码 来 开启 远程 开发 功能 : 

spring: 

devtools: 


remote: 
Secret: myappsecret 


有 了 这 个 属性 后 , 运行 中 的 应 用 程序 就 会 启动 一 个 服务 器 组 件 以 支持 远程 开发 。 它 会 监听 接 
受 变 更 的 请 求 ， 可 以 重启 应 用 程序 或 者 触发 浏览 器 刷新 。 

为 了 使 用 这 个 远程 服务 器 , 你 需要 在 本 地 运行 远程 开发 工具 的 客户 端 ,这 个 远程 客户 端 是 一 
个 类 ， 全 限定 类 名 是 org .springframework.boot.devtools.RemoteSpringApplication。 
它 会 运行 在 IDE 里 ， 要 求 提供 一 个 参数 ， 告 知 远 程 应 用 程序 部 署 在 哪里 。 

例如 ， 假 设 你 正 远 程 运行 阅读 列表 应 用 程序 ， 部 署 在 Cloud Foundry 上， 地 址 是 
https:/readinglist.cfapps.io。 如 果 你 正在 使 用 Eclipse 或 Spring ToolSuite， 可 以 通过 如 下 步骤 开启 远 
程 客户 端 。 

(1) 选择 Run > Run Configurations 菜 单项 。 

(2) 创建 一 个 新 的 Java Application 运 行 配置 。 

(3) 在 Project 里 选中 Reading Lith H ( 可 以 键入 项 目 名 或 者 点 击 Browse 按 钮 找到 这 个 项 目 ， 见 
图 A-1 )。 

(4) 在 Main Class 里 键 人 org.springframework.boot.devtools.RemoteSpringAppli- 
cation ( 风 图 A-1 )。 

(5) 切换 到 Arguments 标 签 页 ， 在 Program Arguments Hi & Amttps://readinglist.cfapps. 
io ( 见 图 A-2 )。 
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eoo Run Configurations 





Create, manage, and run configurations Q 
Run a Java application 


G B x i ame: |ReadingList - RemoteSpringApplication 


o lasspath | B» Source m Environment | ©] Common 




















Apache Tomcat 

[AspectJ Load-Time Weavin! 
AspectJ/Java Application n Browse... | 
© Eclipse Application 
§ Eclipse Data Tools 
Generic Server 


Generic ServerExteral Lau org.springframework.boot.devtools.RemoteSpringApplication| Search... 


Pro 





Main class: 


El Groovy Console 

El Groovy Script |] Include system libraries when searching for a main class 
Ek Groovy Shell [ Include inherited mains when searching for a main class 
8 HTTP Preview 

目 J2EE Preview 口 Stop in main 

E Java Applet 


v [3] Java Application 
[3j ReadingList - RemoteSp 
> Ju JUnit 
Ji JUnit Plug-in Test 
m2 Maven Build 
$ OSGi Framework 
€. Pivotal tc Server 




















> (9) Spring Boot App 
Jy Task Context Test 
X XSL 
Filter matched 28 of 56 items 
© LClose J Run 





图 A-1 RemotespringaApplication 是 远程 开发 者 工具 客户 端 
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S Eclipse Application 
§ Eclipse Data Tools 
8 Generic Server 
8 Generic Server(External Lau 
[p Groovy Console 
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Ji JUnit Plug-in Test 
m2 Maven Build 
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图 A-2” ”RemoteSpringApplication 将 远程 应 用 程序 的 URL 作 为 参数 


客户 端 启动 后 ， 就 可 以 在 IDE 里 修改 应 用 程序 了 。 在 检测 到 变动 后 ， 这 些 修改 点 会 被 推送 到 
远 端 并 加 以 应 用 。 如 果 修 改 的 内 容 涉及 呈现 的 Web 资 源 C 比如 样式 表 或 JavaScript ), LiveReload 
还 还 会 触发 浏览 器 刷新 。 
远程 客户 端 还 会 开启 基于 HTTP 的 远程 调试 通道 ,这 样 就 能 在 IDE 里 调试 部 署 在 远程 的 应 用 程 
序 了 。 你 要 做 的 就 是 确保 远程 应 用 程序 打开 了 远程 调试 功能 。 这 通常 可 以 通过 配置 JAVA_OPTS 
来 实现 。 
比方 说 ， 你 的 应 用 程序 部 署 在 Cloud Foundry 上 ， 可 以 像 下 面 这 样 在 应 用 程序 的 manifest.yml 


里 设置 JAVA_OPTS。 
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env: 
JAVA OPTS: "-Xdebug -Xrunjdwp:server-y,transport-dt socket,suspend-n" 


远程 应 用 程序 启动 后 , 会 和 本 地 调试 服务 器 建立 一 个 连接 。 你 可 以 设置 断 点 ,一 步 步 执行 远 
程 应 用 程序 里 的 代码 ， 就 好 像 它们 运行 在 本 地 一 样 ( 出 于 网 络 原 因 ， 速 度 会 有 点 慢 )。 


A.4 默认 的 开发 时 属性 


有 些 配置 属性 通常 在 开发 时 设置 ， 从 来 不 用 在 生产 环境 里 。 比 如 视图 模板 缓存 ,在 开发 时 最 
好 关 掉 ， 这 样 你 可 以 立刻 看 到 修改 的 结果 。 但 在 生产 环境 里 ， 为 了 追求 更 好 的 性 能 ,应 该 开启 视 
图 模版 缓存 。 
默认 情况 下 ，Spring Boot 会 为 其 支持 的 各 种 视图 模板 ( Thymeleaf, Freemarker, Velocity, 
Mustache 和 Groovy 模 板 ) 开启 缓存 选项 。 但 如 果 存 在 Spring Boot 的 开发 者 工具 ， 这 些 缓存 就 会 
禁用 。 

实际 上 ， 这 就 是 说 在 开发 者 工具 激活 后 ， 如 下 属性 会 设置 为 false。 
口 Spring.thymeleaf.cache 















































LI spring.freemarker.cache 
O spring.velocity.cache 


LI spring.mustache.cache 





LI spring.groovy.template.cache 


这 样 一 来 ， 就 不 用 在 开发 时 ( 在 一 个 开发 时 使 用 的 Profile 配 置 里 ) 禁用 它们 了 。 


AS 全 局 配置 开发 者 工具 


你 应 该 已 经 注意 到 了 , 在 使 用 开发 者 工具 时 ,你 通常 会 在 多 个 项 目 里 使 用 相同 的 设置 。 举 个 
例子 ,如 果 你 使 用 了 重启 触发 文件 , 那么 你 很 可 能 在 多 个 项 目 里 都 使 用 相同 的 触发 文件 名 。 相 比 
在 每 个 项 目 里 重复 开发 者 工具 配置 ， 对 开发 者 工具 做 全 局 配置 显得 更 方便 一 些 。 

要 实现 这 个 目的 ,可 以 在 你 的 主 目录 (home directory ) 里 创建 一 个 名 为 .spring-boot-devtools. 
properties 的 文件 。( 请 注意 ,文件 名 用 “.” 开 头 。) 在 那个 文件 里 ， 你 可 以 设置 希望 在 多 个 项 目 
里 共享 的 各 种 开发 者 工具 属性 。 

例如 ， 假设 你 想 把 触发 文件 的 名 称 设置 为 .trigger, 在 所 有 Spring Boot 项 目 里 禁用 LiveReload。 
你 可 以 创建 一 个 .spring-boot-devtools.properties 文 件 ， 包 含 如 下 内 容 : 
































spring.devtools.restart.trigger-file=.trigger 
spring.devtools.livereload.enabled-false 


要 是 你 想 覆 盖 这 些 配 置 , 可 以 在 每 个 项 目的 application.properties 或 application.yml 文 件 里 设置 
特定 于 每 个 项 目的 属性 。 



































Spring Boot 起 步 依 赖 








Spring Boot 起 步 依 赖 大 大 简化 了 项 目 构建 说 明 中 的 依赖 配置 ,因为 常用 的 依赖 聚合 于 更 粗 粒 


度 的 依赖 。 你 的 构建 项 目 会 传递 解析 到 起 步 依赖 中 声明 的 其 他 依赖 。 











起 步 依赖 不 仅 能 让 构建 说 明 中 的 依赖 配置 更 简单 , 还 根据 提供 给 应 用 程序 的 功能 将 它们 组 织 
到 一 起 。 例如 , 与 其 指定 用 于 验证 的 特定 库 ( 比如 Hibernate Validatorfll Tomcat P3 263 338 ri ), 
还 不 如 简单 地 添加 spring-pboot-starter-validation 起 步 依 赖 。 

表 B-1 列 出 了 Spring Boot 的 所 有 起 步 依赖 ， 还 有 它们 传递 声明 的 依赖 。 


起 步 依赖 


(Group ID: org.springframework.boot) 


表 B-1 


Spring Boot 起 步 依 赖 


传递 依赖 





spring-boot-starter 


spring-boot-starter-actuator 


spring-boot-starter-amqp 


spring-boot-starter-aop 


spring-boot-starter-artemis 


ü org. 
ü org. 
ü org. 


springframewor 
springframewor 


springframewor 


logging 


ü org. 


springframewor 


(excludes commons- 


ü org 


ü org. 
ü org. 
ü org. 
ü org. 
ü org. 
ü org. 
Horg; 
ü org. 
ü org. 
ü org. 
ü org. 





ü org. 


.yaml:snakeyaml 


springframewor 
springframewor 
springframewor 
springframewor 
springframewor 
springframewor 


springframewor 


K 


K 


K 


K 


K 


K. 


K. 


K. 


K: 


K. 


K. 


.boot:spring-boot 
.boot:spring-boot-autoconfigure 


.boot:spring-boot-starter- 


:Spring-core 


logging:commons-logging) 


boot:spring-boot-starter 
boot:spring-boot-actuator 
boot:spring-boot-starter 
Spring-messaging 
amqp:spring-rabbit 
boot:spring-boot-starter 
:Spring-aop 


aspectj:aspectjrt 


aspectj:aspectjweaver 


springframewor 


springframewor 


K 





K 


.boot:spring-boot-starter 


:Spring-jms 


apache.activemq:artemis-jms-client 
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起 步 依赖 


(Group ID; org.springframework.boot) 


传递 依赖 





spring-boot-starter-batch 


spring-boot-starter-cache 


spring-boot-starter-cloud-connectors 


spring-boot-starter-data-elasticsearch 


spring-boot-starter-data-gemfire 


spring-boot-starter-data-jpa 


spring-boot-starter-data-mongodb 


spring-boot-starter-data-rest 


spring-boot-starter-data-solr 


DQ org.springframework.boot:spring-boot-starter 
DQ org.hsqldb:hsqldb 
DQ org.springframework:spring-jdbc 

DQ org.springframework.batch:spring-batch-core 
ü org.springframework.boot:spring-boot-starter 
DQ org.springframework:spring-context 

DQ org.springframework:spring-context-support 

DQ org.springframework.boot:spring-boot-starter 


QD org.springframework.cloud:spring-cloud-spring- 
Service-connector 
Ld org.springframework.cloud:spring-cloud-cloudf- 
oundry-connector 
Llorg.springframework.cloud:spring-cloud-heroku- 
connector 





Lorg.springframework.cloud:spring-cloud-local- 
config-connector 


口 org.springframework.boot:spring-boot-starter 
DQ org.springframework.data:spring-data-elasticsearch 
Lorg.springframework.boot:spring-boot-starter 


D com. gemstone.gemfire:gemfire 
(excludes commons-logging:commons-logging) 


Llorg.springframework.data:spring-data-gemfire 

Lorg.springframework.boot:spring-boot-starter 

Ll org.springframework.boot:spring-boot-starter-aop 

Lorg.springframework.boot:spring-boot-starter- 
jdbc 

Lorg.hibernate:hibernate-entitymanager (excludes 


org.jboss.spec.javax.transaction:jboss-transac- 
tion-api. 1.2, spec) 


口 javax.transaction:javax.transaction-api 

DQ org.springframework.data:spring-data-jpa 
L]org.springframework:spring-aspects 

DQ org.springframework.boot:spring-boot-starter 

Ld org.mongodb:mongo-java-driver 
L]org.springframework.data:spring-data-mongodb 
Lorg.springframework.boot:spring-boot-starter 
Llorg.springframework.boot:spring-boot-starter-web 
C] com. fasterxml.jackson.core:jackson-annotations 

CL] com. fasterxml.jackson.core:jackson-databind 
Llorg.springframework.data:spring-data-rest-webmvc 
Ll org.springframework.boot:spring-boot-starter 
Corg.apache.solr:solr-solrj (excludes 10og4j:109g4j) 





Ll org.springframework.data:spring-data-solr 





口 org.apache.httpcomponents:httpmime 
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CH) 
起 步 依 赖 传递 依赖 

(Group ID: org.springframework.boot) 
spring-boot-starter-freemarker DQ org.springframework.boot:spring-boot-starter 

DQ org.springframework.boot:spring-boot-starter-web 

ü org.freemarker:freemarker 

DQ org.springframework:spring-context-support 
spring-boot-starter-groovy-templates  Llorg.springframework.boot:spring-boot-starter 

DQ org.springframework.boot:spring-boot-starter-web 

DQ org.codehaus.groovy:groovy-templates 
spring-boot-starter-hateoas DQ org.springframework.boot:spring-boot-starter-web 

DQ org.springframework.hateoas:spring-hateoas 

DQ org.springframework.plugin:spring-plugin-core 
spring-boot-starter-hornetq DQ org.springframework.boot:spring-boot-starter 

DQ org.springframework:spring-jms 

DQ org.hornetq:hornetq-jms-client 
spring-boot-starter-integration DQ org.springframework.boot:spring-boot-starter 

DQ org.springframework.boot:spring-boot-starter-aop 

DQ org.springframework.integration:spring-integration- 

core 


spring-boot-starter-jdbc 


Spring-boot-starter-jersey 


Spring-boot-starter-jetty 


file 


http 


el) 





DQ org. 
DQ org. 
DQ org. 
DQ org. 


DQ org. 
tomcat 


DQ org. 
validation 


DQ org. 


springframewor 


apache.tomcat:tomcat-jdbc 


springframewor 
springframewor 


springframewor 


springframewor 


springframewor 


server-impl 


K 


K 


K 


K 





K 


:Spring-jdbc 
.boot:spring-boo 
.boot:spring-boo 


.boot:spring-boo 


:Spring-web 


DQ org.eclipse.jetty:jetty-servlets 
DQ org.eclipse.jetty:jetty-webapp 


DQ org.springframework.integration:spring-integration- 
DQ org.springframework.integration:spring-integration- 


Ld org.springframework.integration:spring-integration-ip 


DQ org.springframework.integration:spring-integration- 
stream 


k.boot:spring-boot-starter 


t-starter 
t-starter- 


t-starter- 


口 com.fasterxml.jackson.core:jackson-databind 


DQ org.glassfish.jersey.core:jersey-server 


DQ org.glassfish.jersey.containers:jersey-container- 
servlet-core 


ü org.glassfish.jersey.containers:jersey-container-servlet 


DQ org.glassfish.jersey.ext:jersey-bean-validation (exclu 


des javax.el:javax.el-api, org.glassfish.web:javax. 


Lorg.glassfish.jersey.ext:jersey-spring3 


DQ org.glassfish.jersey.media:jersey-media-json- 
jackson 


DQ org.eclipse.jetty.websocket:websocket-server 
DQ org.eclipse.jetty.websocket:javax-websocket- 
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(ER) 
起 步 依赖 传递 依赖 
(Group ID: org.springframework.boot) 
spring-boot-starter-jooq Lorg.springframework.boot:spring-boot-starter 


DQ org.springframework.boot:spring-boot-starter-jdbc 
Llorg.springframework:spring-tx 
DQ org.jooqa:jooqd 

spring-boot-starter-jta-atomikos DQ org.springframework.boot:spring-boot-starter 
口 com.atomikos:transactions-jms 


DQ com.atomikos:transactions-jta(excludes 
org.apache.geronimo.specs:geronimo-jta 1.0.1B spec) 


口 com. atomikos:transactions-jdbc 


DQ javax.transaction:javax.transaction-api 





spring-boot-starter-jta-bitronix Lorg.springframework.boot:spring-boot-starter 

DQ javax.jms:jms-api 

DQ javax.transaction:javax.transaction-api 

DQ org.codehaus.btm:btm (excludes javax.transaction:jta) 
spring-boot-starter-10g4j DQ org.slf4j:jcl-over-s1f4j 

DQ org.sl1f4j:jul-to-s1f4j 

DQ org.sl1f4j:s1f4j-109g47j12 

DQ log4j:log4j 
spring-boot-starter-10g4j2 DQ org.apache.logging.109g4j:109g4j-s1f4j-impl 
DQ org.apache.logging.109g4j:109g4j-api 

DQ org.apache.logging.109g4j:109g4j-core 

DQ org.s1f4j:jcl-over-s1f4j 

DQ org.sl1f4j:jul-to-s1f4j 
spring-boot-starter-logging DQ ch.qos.logback:logback-classic 

DQ org.s1f4j:jcl-over-s1f4j 

DQ org.slf4j:jul-to-s1f4j 

DQ org.s1f4j:10o9g4j-over-s1f4j 





spring-boot-starter-mail Lorg.springframework.boot:spring-boot-starter 
Lorg.springframework:spring-context 
Llorg.springframework:spring-context-support 

DQ com.sun.mail:javax.mail 
spring-boot-starter-mobile Lorg.springframework.boot:spring-boot-starter 

DQ org.springframework.boot:spring-boot-starter-web 
Lorg.springframework.mobile:spring-mobile-device 
spring-boot-starter-mustache DQ org.springframework.boot:spring-boot-starter 
Lorg.springframework.boot:spring-boot-starter-web 
口 com.samskivert:jmustache 
spring-boot-starter-redis Lorg.springframework.boot:spring-boot-starter 








Lorg.springframework.data:spring-data-redis 





DQ redis.clients:jedis 
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起 步 依赖 


(Group ID: org.springframework.boot) 


传递 依赖 





spring-boot-starter-remote-shell 


spring-boot-starter-security 


spring-boot-starter-social-facebook 


spring-boot-starter-social-linkedin 


spring-boot-starter-social-twitter 


spring-boot-starter-tes 


Lorg.springframework.boot:spring-boot-starter 
DQ org.springframework.boot:spring-boot-starter-actuator 
D org.crashub:crash.cli 


DQ org.crashub:crash.connectors.ssh(excludes 
org.codehaus.groovy:groovy-all) 

DQ org.crashub:crash.connectors.telnet (excludes javax. 
servlet:servlet-api,log4j:109g4j,commons-logging: 
commonslogging) 
DQ org.crashub:crash.embed.spring(excludes org.spring- 
framework:spring-web,org.codehaus.groovy:groovy-all) 


DQ org.crashub:crash.plugins.cron (excludes 
org.codehaus.groovy:groovy-all) 
DQ org.crashub:crash.plugins.mail (excludes 
org.codehaus.groovy:groovy-all) 





DQ org.crashub:crash.shell(excludes org.codehaus.groovy: 
groovy-all) 








DQ org.codehaus.groovy:groovy 

DQ org.springframework.boot:spring-boot-starter 

DQ org.springframework:spring-aop 
Lorg.springframework.security:spring-security-config 
DQ org.springframework.security:spring-security-web 

DQ org.springframework.boot:spring-boot-starter 

DQ org.springframework.boot:spring-boot-starter-web 
Lorg.springframework.social:spring-social-config 
Lorg.springframework.social:spring-social-core 
Llorg.springframework.social:spring-social-web 
Lorg.springframework.social:spring-social-facebook 
DQ org.springframework.boot:spring-boot-starter 

DQ org.springframework.boot:spring-boot-starter-web 
Lorg.springframework.social:spring-social-config 
Lorg.springframework.social:spring-social-core 
Llorg.springframework.social:spring-social-web 
Lorg.springframework.social:spring-social-linkedin 
DQ org.springframework.boot:spring-boot-starter 

DQ org.springframework.boot:spring-boot-starter-web 
Lorg.springframework.social:spring-social-config 

DQ org.springframework.social:spring-social-core 


Llorg.springframework.social:spring-social-web 














DQ org.springframework.social:spring-social-twitter 
DQ junit:junit 

DQ org.mockito:mockito-core 

DQ org.hamcrest:hamcrest-core 

DQ org.hamcrest:hamcrest-library 


DQ org.springframework:spring-core(excludes 
commons-logging:commons-logging) 





DQ org.springframework:spring-test 
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CER) 
起 步 依 赖 传递 依赖 
(Group ID; org.springframework.boot) 
spring-boot-starter-thymeleaf Dorg.springframework.boot:spring-boot-starter 


Dorg.springframework.boot:spring-boot-starter-web 

Dorg.thymeleaf:thymeleaf-spring4 

Unz.net.ultraq.thymeleaf:thymeleaf-layout-dialect 
spring-boot-starter-tomcat Ll org.apache.tomcat.embed:tomcat-embed-core 

LU org.apache.tomcat.embed:tomcat-embed-el 

Ll org.apache.tomcat.embed:tomcat-embed-logging-juli 





Ll org.apache.tomcat.embed:tomcat-embed-websocket 
spring-boot-starter-undertow LU io.undertow:undertow-core 


LU io.undertow:undertow-servlet(excludes org.jboss. 
Spec.javax.servlet:jboss-servlet-api, 3.1, spec) 


LU io.undertow:undertow-websockets-jsr 

U javax.servlet:javax.servlet-api 

Uorg.glassfish:javax.el 
spring-boot-starter-validation Llorg.springframework.boot:spring-boot-starter 

Ll org.apache.tomcat.embed:tomcat-embed-el 

U org.hibernate:hibernate-validator 
spring-boot-starter-velocity Llorg.springframework.boot:spring-boot-starter 

U org.springframework.boot:spring-boot-starter-web 


Ll commons-beanutils:commons-beanutils 





Ll commons-collections:commons-collections 

D commons-digester:commons-digester 

U org.apache.velocity:velocity 

U org.apache.velocity:velocity-tools 

DQ org.springframework:spring-context-support 
spring-boot-starter-web Llorg.springframework.boot:spring-boot-starter 

DQ org.springframework.boot:spring-boot-starter-tomcat 

LU org.springframework.boot:spring-boot-starter-validation 

Ll com. fasterxml.jackson.core:jackson-databind 

DQ org.springframework:spring-web 

DQ org.springframework:spring-webmvc 
spring-boot-starter-websocket Llorg.springframework.boot:spring-boot-starter 

DQ org.springframework.boot:spring-boot-starter-web 

DQ org.springframework:spring-messaging 

LU org.springframework:spring-websocket 
spring-boot-starter-ws Llorg.springframework.boot:spring-boot-starter 

DQ org.springframework.boot:spring-boot-starter-web 

LU org.springframework:spring-jms 

DQ org.springframework:spring-oxm 


LU org.springframework.ws:spring-ws-core 








LU org.springframework.ws:spring-ws-support 


配置 属性 











虽然 Spring Boot 在 应 用 程序 配置 组 件 时 处 理 了 很 多 “ 粗 活 ”", 但 你 可 能 还 是 想 对 其 中 某 些 组 
件 进 行 微调 。 这 时 就 该 配置 属性 登场 了 。 


第 3 章 介 绍 了 econfigurationProperties 注 解 ， 以 及 它 如 何 暴 露 配 置 在 代码 外 部 的 属性 。 





























pea 





你 可 以 在 自己 创建 的 组 件 上 使 用 aconfigurationProperties 注 解 ， 而 Spring Boot 自 动 配置 的 
很 多 组 件 也 添加 了 econfigurationProperties 注 解 ， 可 以 通过 Spring Boot 支 持 的 各 种 属性 源 
对 其 进行 配置 。 

例如 , 要 指定 内 能 的 Tomecat 或 Jetty 服 务 器 应 监听 的 端口 , 可 以 设置 server.port 属 性 。 这 个 



































属性 可 以 设置 于 application.properties 、application.yml、 操 作 系 统 环境 变量 ， 或 者 是 3.2 节 列 出 的 





其 他 地 方 。 
本 附录 列 出 了 Spring Boot 组 件 提 供 的 全 部 配置 属性 。 请 注意 ， 这 些 属性 是 否 生 效 取决 于 对 应 
的 组 件 是 否 声 明 为 Spring 应 用 程序 上 下 文 里 的 Bean ( 基本 是 自动 配置 的 )， 为 一 个 不 生效 的 组 件 


















































设置 属性 是 没有 用 的 。 


口 





口 


口 


口 


口 


口 





口 


flyway.baseline-description 

执行 基线 时 标记 已 有 Schema 的 描述 。 

flyway.baseline-on-migrate 

在 没有 元 数据 表 的 情况 下 ， 针 对 非 空 Schema 执行 迁移 时 是 否 自动 调用 基线 。( 默认 值 : 


falseo ) 

















Flyway.baseline-version 

执行 基线 时 用 来 标记 已 有 Schema 的 版 本 。( 默认 值 : 1.) 
Flyway.check-location 

检查 迁移 脚本 所 在 的 位 置 是 否 存在 。( 默认 值 : false.) 
Flyway.clean-on-validation-error 

在 验证 错误 时 ， 是 否 自动 执行 清理 。( 默认 值 : false.) 
flyway .enabled 

开启 Flyway。( 默认 值 : true.) 

flyway .encoding 


设置 SQL 迁移 文件 的 编码 。( 默认 值 : UrF-8.) 
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口 flyway.ignore-failed-future-migration 

在 读 元 数据 表 时 ， 是 否 忽略 失败 的 后 续 迁 移 。( 默认 值 : false.) 
D flyway.init-sqls 

获取 连接 后 立即 执行 初始 化 的 SQL 语句 。 

口 flyway.locations 

迁移 脚本 的 位 置 。( 默认 值 : aby/migratione ) 

口 flyway.out-of-order 

是 否 人 允许 乱 序 (out of order) 迁移 。( 默认 值 : false。 ) 

口 flyway.password 

待 迁移 数据 库 的 登录 密码 。 

口 flyway.placeholder-prefix 

设置 每 个 占 位 符 的 前 级 。( 默认 值 : $06) 

D flyway.placeholder-replacement 

是 否 要 替换 占 位 符 。 (默认 值 : true, ) 

D flyway.placeholder-suffix 

设置 占 位 符 的 后 级 。( 默认 值 : Jo) 

D flyway.placeholders.[pblaceholder name] 
设置 占 位 符 的 值 。 

LU flyway.schemas 

Flyway 管 理 的 Schema 列表 ， 区 分 大 小 写 。 黑 认 连 接 对 应 的 默认 Schema。 
口 flyway.sgl-migration-prefix 

SQL 迁移 的 文件 名 前 缀 。( 默认 值 : V。 ) 

口 flyway.sgl-migration-separator 

SQL 迁移 的 文件 名 分 隔 符 。( 默认 值 : o) 

口 flyway.sgl-migration-suffix 

SQL 渤 移 的 文件 名 后 级 。( 默认 值 : .sal。 ) 

D flyway.table 

Flyway 使 用 的 Schema 元 数据 表 名 称 。( 默认 值 : schema version.) 
D flyway.target 

Flyway 要 迁移 到 的 目标 版 本 号 。( 默认 最 新 版 本 。 ) 

ü flyway.url 

待 迁移 的 数据 库 的 JDBC URL。 如 果 没 有 设置 ， 就 使 用 配置 的 主 数据 源 。 
LU flyway .user 

待 迁 移 数 据 库 的 登录 用 户 。 

D flyway.validate-on-migrate 


在 运行 迁移 时 是 否 要 自动 验证 。( 默认 值 : true.) 
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ü liquibase.change-log 
变更 日 志 配 置 路 径 。 (默认 值 : classpath:/db/changelog/db.changelog-master. 
yamlo ) 





D liquibase.check-change-log-location 

检查 变更 日 志 位 置 是 否 存在 。( 默认 值 : crue.) 

D liquibase.contexts 

要 使 用 的 运行 时 上 下 文 列 表 ， 用 逗号 分 隔 。 

ü liquibase.default-schema 

默认 的 数据 库 Schema。 

D liquibase.drop-first 

先 删除 数据 库 Schema。( 默认 值 : false.) 

口 ]icuibase.enabled 

开启 Liquibase 支 持 。( 默认 值 : true.) 

D liquibase.password 

待 迁 移 数 据 库 的 登录 密码 。 

DD liaquibase.url 

待 迁 移 数 据 库 的 JDBC URL。 如 果 没 有 设置 ， 就 使 用 配置 的 主 数据 源 。 

D liquibase.user 

待 迁 移 数据 库 的 登录 用 户 。 

D multipart.enabled 

开启 分 段 (multi-part) 上 传 支持 。( 默认 值 : trues ) 

ü multipart.file-size-threshold 
大 于 该 阔 值 的 文件 会 写 到 磁盘 上 。 这 里 的 值 可 以 使 用 MB 或 KB 后 缀 来 表明 是 兆 字 节 还 是 千 
SB. 默认 值 : 0。) 

D multipart.location 

上 传 文件 的 中 间 存 放 位 置 。 

D multipart.max-file-size 

最 大 文件 大 小 。 这 里 的 值 可 以 使 用 MB 或 KB 后 级 来 表明 是 兆 字 节 还 是 千 字 节 。( 默认 值 : 


1MB» ) 

























































































D multipart.max-request-size 
最 大 请 求 大 小 。 这 里 的 值 可 以 使 用 MB 或 KB 后 缀 来 表明 是 兆 字 节 还 是 千 字 节 。( 默认 值 : 
10MB, ) 




















L] security.basic.authorize-mode 
要 运用 的 安全 授权 模式 。 
口 security.basic.enabled 


开启 基本 身份 验证 。 ( 默认 值 : trues ) 
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口 security.basic.path 
要 保护 的 路 径 ， 用 逗号 分 隔 。( 默认 值 : [/**]。) 
口 security.basic.realm 
HTTP 基 本 领域 (realm ) 用 户 名 。( 默认 值 : Spring。 ) 
口 security.enable-csrf 
开启 跨 站 请 求 伪 造 (cross-site request forgery ) 支持 。( 默认 值 : false。 ) 
口 security.filter-order 
安全 过 滤器 链 顺序 。( 默认 值 : 0.) 
L] security.headers.cache 
开启 缓存 控制 HITP 头 。( 默认 值 : false.) 
口 security.headers.content-type 
开启 X-content-Type-Ooptions 头 。( 默认 值 : false。) 
口 security.headers.frame 
开局 X-Frame-options 头 。 (默认 值 : false.) 
口 security.headers.hsts 
HTTP Strict Transport Security ( HSTS ) 模式 ( 可 设置 为 none、domain、all )。 
L] security.headers.xss 
开启 跨 站 脚本 〈 cross-site scripting ) 保护 。( 默认 值 : false.) 
口 security.ignored 
要 从 默认 保护 路 径 中 排除 掉 的 路 径 列 表 ， 用 逗号 分 隔 。 
CL] security.oauth2.client.access-token-uri 
用 于 获取 访问 令 牌 的 URI。 
D security.oauth2.client.access-token-validity-seconds 


m 





口 











在 令 牌 过 期 前 多 长 时 间 验 证 一 次 。 


security.oaut 





h2.client.additional-information. [key] 


设置 额外 的 信息 ， 令 牌 授予 者 会 将 其 添加 到 令 牌 里 。 


security.oau 





th2.client.authentication-scheme 





传送 持 有 人 令 牌 (bearer token ) 的 方法 , &dfiform, header, none, query, 可 选 其 一 。 
(默认 值 : header, ) 


Secu 


rity. 


oauth2.clie 


要 赋予 经 授权 客户 端的 权 


Secu 


客户 端 可 用 的 授予 类 型 。 


Secu 


客户 端 自动 通过 的 范 





Secu 


rity. 


rity. 





rity. 


oauth2.clie 


oauth2.clie 


B| o 


I 




















oauth2.clie 


"uu 
o 








t.authorities 


.authorized-grant-types 





.auto-approve-scopes 


.client-authentication-scheme 
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在 客户 端 身份 认证 时 用 于 传输 身份 认证 信息 的 方法 , 包括 form、 header、 none、 query, 
可 选 其 一 。( 默认 值 : neader.) 
口 security.oauth2.client.client-id 
OAnuth2 客 户 端 ID。 
D security.oauth2.client.client-secret 
OAnuth2 客 户 端 密 钥 。 默 认 随 机 生成 。 
D security.oauth2.client.grant-type 
获得 资源 访问 令 牌 的 授予 类 型 。 
口 security.oauth2.client.id 
应 用 程序 的 客户 端 ID。 
口 security.oauth2.client.pre-established-redirect-uri 
与 服务 器 预先 建立 好 的 重 定向 URI。 如 果 设 置 了 该 属性 ， 用 户 授权 请 求 中 的 重 定向 URI 会 
被 忽略 ， 因 为 服务 器 不 需要 它 。 
D security.oauth2.client.refresh-token-validity-seconds 
刷新 令 牌 在 过 期 前 的 有 效 时 间 。 
口 security.oauth2.client.registered-redirect-uri 
客户 端 里 注册 的 重 定 向 URI， 用 逗号 分 隔 。 
口 security.oauth2.client.resource-ids 
与 客户 端 关 联 的 资源 ID ， 用 逗号 分 隔 。 
口 security.oauth2.client.scope 
客户 端 分 配 的 域 。 
口 security.oauth2.client.token-name 
令 牌 名 称 。 
口 security.oauth2.client.use-current-uri 
请 求 里 的 当前 URI( 如 果 设 置 了 的 话 ) 是 否 优先 于 预 建立 的 重 定 向 URI。( 默认 值 : trues ) 
D security.oauth2.client.user-authorization-uri 
用 户 要 重 定向 以 便 授 访问 令 牌 的 URI。 
口 security.oauth2.resource.id 
资源 的 标识 符 。 
口 security.oauth2.resource.jwt.key-uri 
JWT 令 牌 的 URI。 如 果 没 有 配置 key-value, 使 用 的 又 是 公 钥 , 那么 可 以 对 这 个 属性 进行 
设置 。 
口 security.oauth2.resource.jwt.key-value 
JWTI 令 牌 的 验证 密 钥 ， 可 以 是 对 称 密 钥 ， 也 可 以 是 PEM 编 码 的 RSA 公 钥 。 如 果 没 有 配置 
这 个 属性 ， 那么 可 以 用 kev-uri 人 代替 。 


口 security.oauth2.resource.prefer-token-info 
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使 用 令 牌 的 信息 ， 设 置 为 false 则 使 用 用 户 信息 。( 默认 值 : crues) 
口 security.oauth2.resource.service-id 
服务 ID。( 默认 值 : resource。 ) 
口 security.oauth2.resource.token-info-uri 
令 牌 解码 端点 URI。 
口 security.oauth2.resource.token-typ 
在 使 用 userInfoUri 时 发 送 的 令 牌 类 型 。 
D security.oauth2.resource.user-info-uri 
用 户 端点 的 URI。 
口 security.oauth2.sso.filter-order 
在 没有 显 式 提 供 websecurityconfigureraAdapter 时 应 用 的 过 滤器 顺序 ， 在 Web- 
SecurityConfigurerAdapter 里 也 可 以 指定 顺序 。 
DQ security.oauth2.sso.login-path 
登录 页 的 路 径 登录 页 是 触发 重 定向 到 OAuth2 授 权 服 务 器 的 页 面 。( 默认 值 : 


/login,) 


















































口 security.require-ssl 

对 所 有 请 求 开 启 安全 通道 。( 默认 值 : false.) 

口 security.sessions 

创建 会 话 使 用 的 策略 。( 可 选 值 包 括 : always. never. if required, stateless.) 
L] security.user.name 

默认 的 用 户 名 。( 默认 值 : user.) 

D security.user.password 

默认 用 户 的 密码 。 

DQ security.user.role 

赋予 默认 用 户 的 角色 。 

口 server.address 

服务 器 绑 定 的 网 络 地 址 。 

口 server.compression.enabled 

是 否 要 开启 压缩 。( 默认 值 : false.) 

口 server.compression.excluded-user-agents 

用 逗号 分 割 的 列表 ， 标明 哪些 用 户 代理 不 该 开启 压缩 。( 可 选 值 包括 : text/html, 


text/xml, text/plain, text/css) 









































口 server.compression.mime-types 
要 开启 压缩 的 MIME 类 型 列表 ， 用 逗号 分 割 。 
口 server.compression.min-response-size 


要 执行 压缩 的 最 小 响应 大 小 〈 单 位 为 字 节 )。( 默认 值 : 2048。) 
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D server.context-parameters.[param name] 
设置 一 个 Servlet 上 下 文 参数 。 

口 server.context-path 

应 用 程序 的 上 下 文 路 径 。 
口 server.display-name 

应 用 程序 的 显示 名 称 。( 默认 值 : application.) 

Ld server.jsp-servlet.class-name 

针对 JSP 使 用 的 Servlet 类 名 。( 默认 值 : org.apache.jasper.servlet.JspServlet.) 
D server.jsp-servlet.init-parameters.[param name] 

设置 JSP Servlet] t 46 

ü server.jsp-servlet.registered 

JSP Servlet E 2; 2 HIE SI EX Servlet ýE (EA: true.) 

口 server.port 
服务 器 的 HTTP 端 口 。 

Ll server.servlet-path 
主 分 发 器 Servlet 的 路 径 。( 默认 值 ，/。) 
D server.session.cookie.comment 
会 话 Cookie 的 注释 。 
L] server.session.cookie.domain 
会 话 Cookie 的 域 。 
口 server.session.cookie.http-only 
会 话 Cookie 的 Httponly 标 记 。 

L] server.session.cookie.max-age 
会 话 Cookie 的 最 大 保存 时 间 ， 单 位 为 秒 。 
L] server.session.cookie.name 

会 话 Cookie 名 称 。 
D server.session.cookie.path 
会 话 Cookie 的 路 径 。 
Ld server.session.cookie.secure 
会 话 Cookie 的 Secure 标 记 。 
L] server.session.persistent 

是 否 在 两 次 重启 间 持 久 化 会 话 数据 。( 默认 值 : falses) 
L] server.session.timeout 

会 话 超时 时 间 ， 单 位 为 秒 。 

L] server.session.tracking-modes 


会 话 跟踪 模式 (包括 : cookie、ur1 和 ss1， 可 选 其 一 或 若干 )。 






























































176 附录 C 配置 属性 





ü server.ssl.ciphers 

支持 的 SSL 加 密 算法 。 

口 server.ssl.client-auth 

客户 端 授 权 是 主动 想 (want) 还 是 被 动 需 要 (need )。 要 有 一 个 TrustStore。 
口 server.ssl.enabled 

是 否 开 启 SSL。( 默认 值 : true.) 

ü server.ssl.key-alias 

在 KeyStore 里 标识 密 钥 的 别名 。 

口 server.ssl.key-password 

在 KeyStore 里 用 于 访问 密 钥 的 密码 。 

DQ server.ssl.key-store 

持 有 SSL 证 书 的 KeyStore 的 路 径 (通常 指向 一 个 .jks 文 件 )。 

D server.ssl.key-store-password 

访问 KeyStore 时 使 用 的 密 钥 。 

口 server.ssl.key-store-provider 

KeyStore 的 提供 者 。 
L] server.ssl.key-store-type 
KeyStore 的 类 型 。 

LI server.ssl.protocol 

要 使 用 的 SSL 协 议 。( 默认 值 : TLS.) 
L] server.ssl.trust-store 

持 有 SSL 证 书 的 TrustStore。 
口 server.ssl.trust-store-password 
用 于 访问 TrustStore 的 密码 。 
L] server.ssl.trust-store-provider 
TrustStore 的 提供 者 。 
D server.ssl.trust-store-type 
TrustStore 的 类 型 。 
L] server.tomcat.access-log-enabled 

是 否 开启 访问 日 志 。( 默认 值 : false。 ) 

DQ server.tomcat.access-log-pattern 

访问 日 志 的 格式 。( 默认 值 : common. ) 

DQ server.tomcat.accesslog.directory 

创建 日 志文 件 的 目录 。 可 以 相对 于 Tomcat 基 础 目录 ,也 可 以 是 绝对 路 径 。( 默认 值 :Logs。 ) 
D server.tomcat.accesslog.enabled 


开启 访问 日 志 。 默认 值 : falses ) 
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口 se 
访 
口 se 
日 
Dse 
日 
Dse 
两 
Dse 





Dse 


匹配 可 信任 代理 


rve 
问 日 


rve 
rve 
rve 


rver 





r.tomcat.accesslog.pattern 
志 的 格式 。( 默认 值 : common.) 


r.tomcat.accesslog.prefix 


志文 件 名 的 前 级 。 


( 默认 值 : access. log.) 


r.tomcat.accesslog.suffix 


志文 件 名 的 后 级 。 


(默认 值 : .1og。) 





r.tomcat.background-processor-delay 
用 backgroundqProcess 方 法 之 间 的 延迟 时 间 ， 单 位 为 秒 。( 默认 值 : 30.) 


r.tomcat.basedir 





rver 











Tomcat 的 基础 目录 。 如 果 没 有 指定 则 使 用 一 个 临时 目录 。 





r.tomcat.internal-proxies 








服务 器 的 正则 表达 式 。 默 认 值 :“10\Adf13N d (3). 4 (1,33]192 168 Ad 


(1,3) (1,3)] 169,254 d (1,33 Ad (1,33] 127 (1,33 1,328 (1,33]172.1[6-9] 10A (1,3) 
V L3] 172:2[0-9] 1d (1,33 (1,33 ]72,3[0-1] 10M (1,33 (1,31 


ü se 


Dse 


rve 


HTTP 消 


rve 


KT. 


rve 








r.tomcat.max-http-header-size 
息 头 的 最 大 字 节 数 。( 默认 值 : 0.) 
r.tomcat.max-threads 
作 线 程 数 。( 默认 值 : 0.) 


r.tomcat.port-header 














Dse 


用 来 覆盖 原 








rve 





台 端口 值 的 HTTP 头 的 名 字 。 


r.tomcat.protocol-header 





持 有 流入 协议 的 HTTP 头 ， 通 常 的 名 字 是 x-Forwardedq-Proto。 仅 当 设 置 了 remoteIp- 
Headqezr 的 时 候 ， 它 会 被 配置 为 RemoteIpValve。 











L] server.tomcat.protocol-header-https-value 
协议 头 的 值 ， 表 明 流入 请 求 使 用 了 SSL。( 默认 值 : https.) 


口 server.tomcat.remote-ip-header 











表明 从 哪个 HTTP 头 里 可 以 提取 到 远 端 P。 仪 当 设置 了 remoteIpHeader 的 时 候 ， 它 会 被 








T 


ü se 








rve 


rve 


EVO 


LE JJRemotelpValve, 


r.tomcat.uri-encoding 


用 来 解码 URI 的 字符 编码 。 








r.undertow. 


r.undertow. 











access-log-dir 





dertow 的 访问 日 志 目 录 。( 默认 值 : 1ogs。) 


access-log-enabled 





否 开启 访问 日 志 。 ( 默认 值 : false.) 





rve 








r.undertow. 





access-log-pattern 
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访问 日 志 的 格式 。( 默认 值 : common. ) 


口 server.undertow 


口 server.undertow 





口 server.undertow 
口 server.undertow 
每 个 缓冲 的 字 节 数 。 


口 server.undertow 


口 server.undertow 





口 server.undertow 














口 server.undertow 
工作 线程 数 。 


口 spring.activemq 





口 spring.activemq 


每 个 区 (region ) 的 缓冲 数 。 


在 Java 堆 外 分 配 缓冲 。 


.accesslog.dir 


Undertow 访 问 日 志 目 录 。 


.accesslog.enabled 


开启 访问 日 志 。 ( 默认 值 : falses ) 


.accesslog.pattern 


访问 日 志 的 格式 。( 默认 值 : common。 ) 


.buffer-size 


.buffers-per-region 


.direct-buffers 


.io-threads 


要 为 工作 线程 创建 的 IO 线程 数 。 


.Wworker-threads 





.broker-url 





ActiveMQ 代 理 的 URL。 默 认 自 动 生成 。 


.in-memory 























标明 默认 代理 URL 是 否 应 该 在 内 存 里 。 如 果 指 定 了 一 个 显 式 的 代理 则 忽略 该 属性 。( 默认 





fH: true, ) 
LI spring.activemq 
代理 的 登录 密码 。 


口 spring.activemq 














"uni 


.password 


.pooled 


标明 是 否 要 创建 一 个 PooledconnectionFactory 来 代替 普通 的 connectionFactory。 





(默认 值 : false。 ) 
口 spring.activemq 
代理 的 登录 用 户 名 。 


口 spring.aop.auto 


























的 代理 ， 前 者 为 tru 


ū spring.applicat 





ion.admin.enabled 


.user 





添加 eEnableAspectJAutoProxy。( 默认 值 : true.) 
D spring.aop.proxy-target-class 


是 否 要 创建 基于 子 类 ( 即 Code Generation Library, CGLIB ) 的 代理 来 代替 基于 Java 接 口 


e， 后 者 为 false。( 默认 值 : false。 ) 











开启 应 用 程序 的 管理 











E 功 能 。( 默认 值 : false.) 
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D spring.application.admin.jmx-name 
应 用 程序 管理 MBean 的 JMX 名 称 。( 默认 值 : org.springframework.boot:type- 


Admin,name-SpringApplication,) 








spring.artemis.embedded.cluster-password 
集群 密码 。 默 认 在 启动 时 随机 生成 。 
口 spring.artemis.embedded.data-directory 
Journal 文 件 目录 。 如 果 关 闭 了 持久 化 则 不 需要 该 属性 。 
D spring.artemis.embedded.enabled 
WRA Artemis] 25-8 APINA ARAR CEA: true.) 
L] spring.artemis.embedded.persistent 
开启 持久 化 存储 。( 默认 值 : false.) 
L] spring.artemis.embedded.queues 
要 在 启动 时 创建 的 队列 列表 ， 用 逗号 分 隔 。( 默认 值 : D 
口 spring.artemis.embedded.server-id 
服务 器 ID。 默 认 情 况 下 ， 使 用 一 个 自动 递增 的 计数 器 。( 默认 值 : 0.) 
口 spring.artemis.embedded.topics 
在 启动 时 要 创建 的 主题 列表 ， 用 逗号 分 隔 。( 默认 值 : D.) 
口 spring.artemis.host 
Artemis 代 理 主机 。( 默认 值 : localhost.) 
口 spring.artemis.mode 
Artemis 部 署 模 式 ， 默 认 自 动 检测 。 可 以 显 式 地 设置 为 native 或 embeddqea。 
口 spring.artemis.port 
Artemis 代 理 端 口 。( 默认 值 : 61616.) 
D spring.autoconfigure.exclude 
要 排除 的 自动 配置 类 。 
口 spring.batch.initializer.enabled 
如 果 有 必要 的 话 ， 在 启动 时 创建 需要 的 批 处 理 表 。( 默认 值 : true。 ) 
口 spring.batch.job.enabled 
在 启动 时 执行 上 下 文 里 的 所 有 Spring Batch 任 务 。( 默认 值 : true.) 
口 spring.batch.job.names 
启动 时 要 执行 的 任务 名 列表 ， 用 去 号 分 隔 。 默 认 在 上 下 文 里 找到 的 所 有 任务 都 会 执行 。 
D spring.batch.schema 
指向 初始 化 数据 库 Schema 用 的 SQL 文 件 的 路 径 。( 默认 值 : classpath:org/ 


springframework/batch/core/schema-@@platform@@.sqlo ) 





































































































ü spring.batch.table-prefix 


所 有 批 处 理 元 数据 表 的 表 前 级 。 
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口 spring.cache.cache-names 
如 果 底 层 缓存 管理 器 支持 缓存 名 的 话 ， 可 以 在 这 里 指定 要 创建 的 缓存 名 列表 ， 用 逗号 分 
隔 。 通 常 这 会 禁用 运行 时 创建 其 他 额外 缓存 的 能 力 。 

L] spring.cache.ehcache.config 

用 来 初始 化 EhCache 的 配置 文件 的 位 置 。 

DD spring.cache.guava.spec 

用 来 创建 缓存 的 Spec。 要 获得 有 关 Spec 格 式 的 详细 情况 ， 可 以 查看 cacheBuilderspec。 

口 spring.cache.hazelcast.config 

用 来 初始 化 Hazelcast 的 配置 文件 的 位 置 。 

D spring.cache.infinispan.config 

用 来 初始 化 Infinispan 的 配置 文件 的 位 置 。 

ū spring.cache.jcache.config 

用 来 初始 化 缓存 管理 器 的 配置 文件 的 位 置 。 配 置 文件 依赖 于 底层 的 缓存 实现 。 

口 spring.cache.jcache.provider 
cachingProvider 实 现 的 全 限定 类 名 ， 用 来 获取 JSR-107 兼 容 的 缓存 管理 器 ， 仅 在 
Classpath 里 有 不 只 一 个 JSR-107 实 现时 才 需 要 这 个 属性 。 

口 spring.cache.type 

缓存 类 型 ， 默 认 根据 环境 自动 检测 。 


















































D spring.dao.exceptiontranslation.enabled 











打开 P rsistenceExceptionTranslationPostProcessor,; (默认 值 : trues ) 
口 spring.data.elasticsearch.cluster-name 

Elasticsearch 集 群 名 。( 默认 值 : elasticsearch ) 

D spring.data.elasticsearch.cluster-nodes 

集群 节点 地 址 列表 ， 用 逗号 分 隔 。 如 果 没 有 指定 ， 就 启动 一 个 客户 端 节 点 。 

口 spring.data.elasticsearch.properties 

用 来 配置 客户 端的 额外 属性 。 
D spring.data.elasticsearch.repositories.enabled 
开启 Elasticsearch 仓 库 。( 默认 值 : crue.) 
D spring.data.jpa.repositories.enabled 

开启 JPA 仓 库 。 (默认 值 : true.) 

口 spring.data.mongodb.authentication-database 
身份 认证 数据 库 名 。 

D spring.data.mongodb.database 

数据 库 名 。 
口 spring.data.mongodb.field-naming-strategy 


要 使 用 的 FielaqNamingdSstrategy 的 全 限定 名 o 
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口 spring.data.mongodb.grid-fs-database 
GridFS 数 据 库 名 称 。 
口 spring.data.mongodb.host 
Mongo/lit «s 3: BLUE o 
口 spring.data.mongodb.password 
Mongo 服 务 需 的 登录 密码 。 


口 spring.data. 





ongodb.port 
Mongo 服 务 器 端口 号 。 
口 spring.data.mongodb.repositories.enabled 
开启 Mongo 仓 库 。( 默认 值 : true.) 
L] spring.data.mongodb.uri 
Mongo 数 据 库 URI。 设 置 了 该 属性 后 就 主机 和 端口 号 会 被 忽略 。( 默认 值 : mongodb:// 


localhost/test,) 





























DD spring.data.mongodb.username 

Mongo 服 务 需 的 登录 用 户 名 。 

口 spring.data.rest.base-path 

用 于 发 布 仓库 资源 的 基本 路 径 。 

口 spring.data.rest.default-page-size 

分 页 数据 的 默认 页 大 小 。( 默认 值 : 209) 

ü spring.data.rest.limit-param-name 

用 于 标识 一 次 返回 多 少 记 录 的 URL 查 询 字 符 串 参数 名 。( 默认 值 : size.) 
口 spring.data.rest.max-page-size 

最 大 分 页 大 小 。( 默认 值 : 1000。 ) 

D spring.data.rest.page-param-name 

URL 查 询 字 符 串 参数 的 名 称 ， 用 来 标识 返回 哪 一 页 。( 默认 值 : pages ) 
口 spring.data.rest.return-body-on-create 

在 创建 实体 后 是 否 返 回 一 个 响应 体 。( 默认 值 : false.) 

口 spring.data.rest.return-body-on-update 

在 更 新 实体 后 是 否 返 回 一 个 响应 体 。( 默认 值 : false.) 

D spring.data.rest.sort-param-name 

URIL 查 询 字符 串 参 数 的 名 称 ， 用 来 标识 结果 排序 的 方向 。( 默认 值 ，sort。) 
ü spring.data.solr.host 

Sotr 的 主机 地 址 。 如 果 设 置 了 zk-host 则 忽略 该 属性 。( 默认 值 : http://127.0.0.1: 
8983/solr.) 


D spring.data.solr.repositories.enabled 


开启 Solr 仓 库 。 (默认 值 : true, ) 
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一 个 











D spring.data.solr.zk-host 
ZooKeeper 主 机 地 址 ， 格 式 为 “主机 :端口 ”。 


D spring.datasource.abandon-when-percentage-full 





AAEREN, SEHIAPUMEUISBIJEEHSETEIH (超时 ) 的 连接 。 








口 spring.datasource.allow-pool-suspension 
是 否 允 许 池 暂停 ( pool suspension )。 在 开启 池 和 暂停 后 会 有 性 能 会 受到 一 定 影响 ， 除 非 你 
真 的 需要 这 个 功能 (例如 在 宛 余 的 系统 下 )， 否 则 不 要 开启 它 。 该 属性 只 在 使 用 Hikari 数 














据 库 连 接 池 时 有 用 。( 默认 值 : false。 ) 














是 否 








在 所 


连接 


指向 














CL spri 


CL spri 


ü spri 





ng 


ng 





ng. d 
允许 使 用 其 他 用 户 名 。 
ü spri 
更 新 操作 
口 spri 
默认 的 Catalog 名 称 。 
ü spri 
在 连接 归还 时 ， 连 接 池 是 否 


ng.d 


ng.d 


ng.d 
有 新 连接 创建 时 都 会 执 


ü spri 


ng. d 
超时 
口 spring.q 


ng.d 
ü spri 
用 于 获取 连接 的 数据 源 的 全 限定 类 名 。 
ü spri 
用 于 获取 连接 的 数据 源 的 JNDI 位 置 。 
UO spri 

设置 创建 数据 源 时 使 月 


ng. 





.datasource.con 
理 连 接 第 一 次 创建 时 执行 的 SQL 语句 列表 。( 用 于 DBCP 连 接 池 。) 
.datasource.con 
建 连接 时 使 用 的 属性 
.datasource.con 
用 于 测试 连接 有 效 性 的 SQL 查询 。 
口 spri j 





.d 


.d 


d 


是 否 自动 提交 。 


ng.d 





atasource.alt 


rnat 


-username-allowed 





atasource.auto-commit 


atasource.catalog 


atasource.coln 


it-on 





-return 














atasource.con 





atasource.con 
(Hopp ER )。 


atasource.con 





nectio 


nectio 


nectio 


neccio 








nectio 





atasource.data 


要 提交 挂 起 的 事务 。 








n-init-sqgl 





行 的 SQL 语句 ， 该 语句 会 在 连接 加 入 连接 池 前 执行 。 


n-init-sqls 





n-properties.([key] 


。( 用 于 DBCP 连 接 池 。) 


n-test-query 





n-timeout 


tinue-on-error 
初始 化 数据 库 时 发 生 错 误 不 要 终止 。( 默认 值 : falses) 


C spri 





(数据 库 操 纵 语 言 ，Data Manipulation Language, DML ) 脚本 资源 的 引用 。 


atasource.data-source-class-name 


atasource.data-source-jndi 














atasource.data-source-properties.[key] 











HRS TE. C 用 于 Hikari 连 接 池 。 ) 
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spri 
设置 创建 数据 源 时 使 用 的 属性 
spri 
连接 上 的 操作 是 否 
spri 
连接 的 默认 Catalog。 
spri 
连接 的 默认 只 读 状 
spri 
连接 的 默认 事务 隔 
spri 
JDBCIK IRJ 4 B 
spri 
是 否 以 FIFO 方 式 返 回 
Spri 
设置 要 纳入 健康 检 
spri 
连接 池 中 的 
spri 
初始 化 数据 库 连接 
spri 
在 连接 第 一 次 创建 


spri 


ng.datasou 





ng.datasou 


ng.datasou 





ng.datasou 


ng.datasou 





ng.datasou 


ng.datasou 


ng.datasou 








ng.datasou 
连接 能 


ng.datasou 





ng.datasou 


ng.datasou 














在 连接 池 启 动 时 
spri 
在 连接 池 创 建 时 ， 
spri 
使 用 data.sql 初 始 化 数据 库 。( 默认 值 : true。 ) 
Spri 
是 否 要 隔离 内 部 请 求 。( 默认 值 : 
spri 


一 个 分 号 分 





ng.datasou 





ng.datasou 


ng.datasou 








ng.datasou 


roperties 

E; CHE T Tomcat 
Faul 
自动 提交 。 


rce.de 


rce.db-p 








车 接 池 。) 


rce.de t-auto-commit 


Fault-catalog 


rce.def 
太 


Wo 


lt-read-only 





rce.default-transaction-isolation 
离 级 别 。 


rce.driver-class-name 





定 类 名 。 默 认 根 据 URL 自 动 检测 。 





rce.fair-queue 


连接 。 
rce.health-check-properties. 


查 的 属性 。( 用 于 Hikari 连 接 池 。) 


rce.idle-timeout 


[key] 





cr 





保持 闲置 状态 的 最 长 时 间 ， 单 位 为 毫秒 。( 默认 值 : 


rce.ignore-exception-on-pre-load 
池 时 是 否 要 忽略 连接 。 
rce.init-sqgl 

时 运行 的 自 定义 查询 。 
rce.initial-size 

建立 的 连接 数 。 
rce.initialization-fail-fast 
如 果 达 不 到 最 小 连接 数 是 否 要 抛 出 异常 


rce.ini 

















tialize 








rce.isolate-internal-queries 


false.) 





rce.jdbc-interceptors 


隔 的 类 名 列表 , 这 些 类 都 扩展 了 JdbcInterceptor 类 。i 


java.sql.Connection 对 象 的 操作 和 链 里 。( 用 于 Tomcat 连 接 池 。) 








用 来 创建 连 : 








D spring.datasource.jdbc-url 
赚 的 JDBC URL. 


ü spring.datasource.jmx-enabled 


10。) 


o GAB: true, ) 


这 些 拦截 带 会 插 





A 


入 
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开启 JMX 文 持 〈 如 果 底 层 连 接 池 提 供 该 功能 的 话 )。( 默认 值 : false.) 
口 spring. datasource.jndi-name 
数据 源 的 JNDI 位 置 。 设 置 了 该 属性 则 忽略 类 、URL、 用 户 名 和 密码 属性 。 
口 spring.datasource.leak-detection-threshold 
用 来 检测 Hikari 连 接 池 连 接 泄露 的 阔 值 ， 单 位 为 毫秒 。 
口 spring.datasource.log-abandoned 
是 否 针 对 弃 用 语句 或 连接 的 应 用 程序 代码 记录 下 跟踪 栈 。 用 于 DBCP 连 接 池 。( 默认 值 : 


falses ) 





























口 spring.datasource.log-validation-errors 
在 使 用 Tomcat 连 接 池 时 是 否 要 记录 验证 错误 。 
D spring.datasource.login-timeout 
连接 数据 库 的 超时 时 间 ( 单位 为 秒 )。 
D spring.datasource.max-active 
连接 池 中 的 最 大 活跃 连接 数 。 
口 spring.datasource.max-age 
连接 池 中 连接 的 最 长 寿命 。 
口 spring.datasource.max-idle 
连接 池 中 的 最 大 空闲 连接 数 。 
D spring.datasource.max-lifetime 
连接 池 中 连接 的 最 长 寿命 〈 单 位 为 毫秒 )。 
D spring.datasource.max-open-prepared-statements 
开启 状态 的 Pr paredStatem nt 的 数量 上 限 。 
D spring.datasource.max-wait 
连接 池 在 等 待 返回 连接 时 ， 最 长 等 竺 多 少 毫秒 再 抛 出 异常 。 
L] spring.datasource.maximum-pool-size 
连接 池 能 达到 的 最 大 规模 ， 包 含 空闲 连接 的 数量 和 使 用 中 的 连接 数量 。 
口 c e in-evictable-idle-time-millis 
空闲 连接 被 空闲 连接 释放 器 (如果 存在 的 话 ) 优雅 地 释放 前 ， 最 短 会 在 连接 池 里 停 
INE 
口 spring.datasource.min-idle 
连接 池 里 始终 应 该 保持 的 最 小 连接 数 。( 用 于 DBCP 和 Tomcat 连 接 池 。) 
口 spring.datasource.minimum-idle: 
HikariCP 试 图 在 连接 池 里 维持 的 最 小 空闲 连接 数 。 
口 spring.datasource.name 
数据 源 的 名 称 。 


口 spring.datasource.num-tests-per-eviction-run 








T 
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空 亲 对象 释放 器 线程 (如果 存 在 的 话 ) 每 次 运行 时 要 检查 的 对 象 数 。 


spri 





ng.datasou 
数据 库 的 登录 密码 
spri 
在 Schema 资 
spri 


ng.datasou 


ng.datasou 


ng.datasou 


o 





rce.password 


rce.platform 

源 (schema-$ {platform}.sql ) 里 要 使 用 的 平台 。( 默认 值 : alls) 
ng.datasou 
连接 池 名 称 。 
spri 
是 否 要 将 Stateme 
spri 


rce.pool-name 


rce.pool-prepared-statements 
nt 放 在 池 里 。 


rce.propagate-interrupt-state 


对 于 等 待 连接 的 中 断 线程 ， 是 否 要 传播 中 断 状 态 。 


spri 


ng.datasou 


rce. 





read-only 


在 使 用 Hikari 连 接 池 时 将 数据 源 设 置 为 只 读 。 


spri 


ng.datasou 


.register-mbeans 





rc 


Hikari 连 接 池 是 否 要 注册 JMX MBean。 


spri 


被 弃 


ng .da 


ng.da 


ng.datasou 
用 的 连接 在 到 达 弃 用 超时 后 是 否 应 该 被 移 除 。 
spri 
连接 在 多 少 秒 后 应 i 


spri 


casou 


casou 


rce. 


rce. 
该 考虑 弃 用 。 


rce. 


remove-abandoned 











remove-abandoned-timeout 


rollback-on-return 























在 连接 归还 连接 池 时 ， 是 否 要 回 深 挂 起 的 事务 。 


spri 
Schema ( 数 
spri 


ng.da 


ng.da 


Casou 


casou 


据 定义 


rce.schema 
语言 ，Data Definition Language, DDL ) 脚本 资源 的 引用 。 


rce.separator 








SQL 初始 化 脚本 里 的 语句 分 割 符 。( 默认 值 : ;。) 


spri 
SQL 脚本 的 编码 。 


spri 


在 记 


spri 


从 连 


spri 


ng.da 


ng.da 
录 一 个 


ng.da 


casou 


casou 


casou 


rce.sql-script-encoding 


rce.suspect-timeout 
疑似 弃 用 连接 前 要 等 待 多 少 秒 。 


rce. 


test-on-borrow 





接 池 中 


ng.da 





casou 





PHERI Je RETI. 


rce. 


cest-on-connect 








在 建立 连接 时 是 否 要 进行 测试 。 
spri 


在 将 








spri 











ng.da 
连接 归 





ng.da 


casou 
AF 


casou 











rce. 


test-on-return 








1 连接 池 时 是 否 要 进行 测试 。 


rce. 











test-while-idle 
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在 连接 空闲 时 是 否 要 进行 测试 。 
口 spring.datasource.time-between-eviction-runs-millis 
在 两 次 空闲 连接 验证 、 弃 用 连接 清理 和 空闲 池 大 小 调整 之 间 睡 眠 的 毫秒 数 。 
口 spring.datasource.transaction-isolation 
在 使 用 Hikari 连 接 池 时 设置 默认 事务 隔离 级 别 。 
口 spring.datasource.url 
数据 库 的 JDBC URL。 
口 spring.datasource.use-disposable-connection-facade 
连接 是 否 要 用 一 个 门面 (facade ) 封装 起 来 ， 在 调用 了 connection.close() 后 就 不 能 
再 使 用 这 个 连接 了 。 
口 spring.datasource.use-equals 
在 比较 方法 名 时 是 否 使 用 string .equals () 来 代替 -==。 
D spring.datasource.use-lock 
在 操作 连接 对 象 时 是 否 要 加 锁 。 
D spring.datasource.username 
数据 库 的 登录 用 户 名 。 
口 spring.datasource.validation-interval 
执行 连接 验证 的 间 隅 时 间 ， 单 位 为 毫秒 。 
口 spring.datasource.validation-query 
在 连接 池 里 的 连接 返回 给 调用 者 或 连接 池 时 ， 要 执行 的 验证 SQL 查询 。 
口 spring.datasource.validation-query-timeout 
在 连接 验证 查询 执行 失败 前 等 待 的 超时 时 间 ， 单 位 为 秒 。 
D spring.datasource.validation-timeout 
在 连接 验证 失败 前 等 待 的 超时 时 间 ， 单 位 为 秒 。( 用 于 Hikari 连 接 池 。 ) 
口 spring.datasource.validator-class-name 
可 选 验证 需 类 的 全 限定 类 名 ， 用 于 执行 测试 查询 。 
口 spring.datasource.xa.data-source-class-name 
XA 数据 源 的 全 限定 类 名 。 
D spring.datasource.xa.properties 
要 传递 给 XA 数据 源 的 属性 。 
D spring.freemarker.allow-request-overrid 
HttpServletRecuest 的 属性 是 否 人 允许 覆盖 〈 隐藏 ) 控制 器 生成 的 同名 模型 
D spring.freemarker.allow-session-override 
HttpSession 的 属性 是 否 允 许 覆 盖 ( 隐藏 ) 控制 器 生成 的 同名 模型 属性 。 
口 spring.freemarker.cache 


开局 模板 缓存 。 
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Spring.freemarker.charset 
模板 编码 。 
Sspring.freemarker.check-template-location 
检查 模板 位 置 是 否 存 在 。 
spring.freemarker.content-type 
Content-Typell] Ho 


























spring.fr arker.enabled 

开启 FreeMarker 的 MVC 视 图 解析 。 
spring.freemarker.expose-request-attributes 

在 模型 合并 到 模板 前 ， 是 否 要 把 所 有 的 请 求 属性 添加 到 模型 里 。 

spring.fr arker.expose-session-attributes 

在 模型 合并 到 模板 前 ， 是 否 要 把 所 有 的 Httpsession 属 性 添加 到 模型 里 。 

spring.fr arker.expose-spring-macro-helpers 

是 否 发 布 供 Spring 宏 程序 库 使 用 的 RequestContext ， 并 将 命 其 名 为 springMacro- 


RequestContexto 



















































































spring.freemarker.prefer-file-system-access 

加 载 模板 时 优先 通过 文件 系统 访问 。 文 件 系统 访问 能 够 实时 检测 到 模板 变更 。( 默认 值 : 
trueo ) 

Spring.freemarker.prefix 

在 构建 URL 时 添加 到 视图 名 称 前 的 前 缀 。 


spring.fr arker.request-context-attribute 


在 所 有 视 图 里 使 用 的 RequestContext 属性 的 名 称 。 


spring.freemarker.settings 

要 传递 给 FreeMarker 配 置 的 各 种 键 。 

spring.freemarker.suffix 

在 构建 URL 时 添加 到 视图 名 称 后 的 后 级。 

spring.fr arker.template-loader-path 

模板 路 径 列表 ， 用 逗号 分 隔 。( 默认 值 : ["classpath:/templates/"]。) 


spring.fr arker.view-names 

可 解析 的 视图 名 称 的 白 名 单 。 
Spring.groovy.template.allow-request-overrid 
HLtpServletRedquest 的 属性 是 否 人 允许 覆盖 〈 隐藏 ) 控制 器 生成 的 同名 模型 属性 。 
spring.groovy.template.allow-session-override 
HttpSession 的 属性 是 否 允许 覆盖 〈 隐藏 ) 控制 器 生成 的 同名 模型 属性 。 
Spring.groovy.template.cach 


开启 模板 缓存 。 
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口 spring.groovy.template.charset 








模板 编码 。 
口 spring.groovy.template.check-template-location 
检查 模板 位 置 是 否 存在 。 





DQ spring.groovy.template.configuration.auto-escape 
模型 变量 在 模板 里 呈现 时 是 否 要 做 转 义 。( 默认 值 : false。 ) 
D spring.groovy.template.configuration.auto-indent 
模板 是 否 要 自动 呈现 缩 进 。( 默认 值 : false.) 
D spring.groovy.template.configuration.auto-indent-string 
开启 自动 缩 进 时 用 于 缩 进 的 字符 串 , 可 以 是 sPACES, 也 可 以 是 TAB。( 默认 值 : sPACI 
口 spring.groovy.template.configuration.auto-new-line 
模板 里 是 和 否 要 呈现 新 的 空 行 。( 默认 值 : false.) 
口 spring.groovy.template.configuration.base-template-class 
模板 基 类 。 
D spring.groovy.template.configuration.cache-templates 
模板 是 否 应 该 缓存 。( 默认 值 : true.) 
D spring.groovy.template.configuration.declaration-encoding 
用 来 写 声 明 头 的 编码 。 
口 spring.groovy.template.configuration.expand-empty-elements 

没有 正文 的 元 素 该 用 短 形式 (例如 ，<br/>) 还 是 扩展 形式 (例如 ，<br></br> ) 来 书 

写 。( 默认 值 : false.) 
口 spring.groovy.template.configuration.locale 
设置 模板 地 域 。 
D spring.groovy.template.configuration.new-line-string 
在 自动 空 行 开启 后 用 来 呈现 空 行 的 字符 串 。( 默认 为 系统 的 line .separator 属 性 值 。) 
口 spring.groovy.template.configuration.resource-loader-path 
Groovy 模 板 的 路 径 。 (默认 值 : classpath:/templates/。) 
ü spring.groovy.template.configuration.use-double-quotes 
属性 是 该 用 双 引 号 还 是 单 引号 。( 默认 值 : false.) 
ü spring.groovy.template.content-type 
content -Type 的 值 。 

















车 
[05] 
o 
rud 
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D spring.groovy.template.enabled 
开启 Groovy 模 板 的 MVC 视 图 解析 。 
D spring.groovy.template.expose-request-attributes 

















在 模型 合并 到 模板 前 ， 是 否 要 把 所 有 的 请 求 属性 添加 到 模型 里 。 


D spring.groovy.template.expose-session-attributes 
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在 模型 合并 到 模板 前 ， 是 否 要 把 所 有 的 Httpsession 属 性 添加 到 模型 里 。 
Spring.groovy.template.expose-spring-macro-helpers 
是 否 发 布 供 Spring 宏 程序 库 使 用 的 Requestcontext ， 并 将 其 命名 为 springMacro- 


RequestContexto 











Spring.groovy.template.prefix 

在 构建 URL 时 ， 添 加 到 视图 名 称 前 的 前 缀 。 
Spring.groovy.template.request-context-attribute 
所 有 视图 里 使 用 的 Requestcontext 属 性 的 名 称 。 
spring.groovy.template.resource-loader-path 
模板 路 径 ( 默认 值 : classpath:/ templates/.) 
Spring.groovy.template.suffix 

在 构建 URL 时 ， 添 加 到 视图 名 称 后 的 后 绥 。 
spring.groovy.template.view-names 

可 解析 的 视图 名 称 白 名 单 。 
spring.h2.console.enabled 

开启 控制 台 。( 默认 值 : false.) 
spring.h2.console.path 

可 以 找到 控制 台 的 路 径 。( 默认 值 : /n2-console.) 
spring.hateoas.apply-to-primary-object-mapper 
指定 主 objectMapper 是 否 要 应 用 HATEOAS 支 持 。( 默认 值 : true.) 
spring.hornetq.embedded.cluster-password 
集群 密码 。 默 认 在 启动 时 随机 生成 。 
spring.hornetq.embedded.data-directory 

日 志文 件 目 录 。 如 果 关 闭 了 持久 化 功能 则 不 需要 该 属性 。 
spring.hornetq.embedded.enabled 

ti f HornetQll ZAPI, WIJFJG BO AX. CERA: true.) 
spring.hornetq.embedded.persistent 

开启 持久 化 存储 。( 默认 值 : false.) 
spring.hornetq.embedded.queues 

启动 时 要 创建 的 队列 列表 ， 用 逗号 分 隔 。( 默认 值 : [] 。) 
spring.hornetq.embedded.server-id 

服务 器 ID 。 默 认 使 用 自 增长 计数 器 。( 默认 值 : 0.) 
spring.hornetq.embedded.topics 

启动 时 要 创建 的 主题 列表 ， 用 逗号 分 隔 。( 默认 值 : [] 。) 
spring.hornetq.host 


HornetQ 的 主机 。( 默认 值 : localhost.) 
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D spring.hornetq.mode 

HormetQ 的 部 署 模式 ， 默 认为 自动 检测 。 可 以 显 式 地 设置 为 native 或 embedqed。 

口 spring.hornetq.port 

HometQ 的 端口 。( 默认 值 : 5445。 ) 

口 spring.http.converters.preferred-json-mapper 

HTTP 消 息 转 换 时 优先 使 用 JSON 映 射 器 。 

LU spring.http.encoding.charset 
HTTP 请 求 和 响应 的 字符 集 。 如 果 没 有 显 式 地 指定 content -Type 头 ， 则 将 该 属性 值 作为 
这 个 头 的 值 。( 默认 值 : UTF-8。) 

口 spring.http.encoding.enabled 

开启 HTTP 编 码 支 持 。( 默认 值 : true.) 

LI spring.http.encoding.force 

强制 将 HTTP 请 求 和 响应 编码 为 所 配置 的 字符 集 。( 默认 值 : true.) 

D spring.jackson.date-format 

日 期 格式 字符 串 (yyyy-MM-dd HH:mm:ss ) 或 日 期 格式 类 的 全 限定 类 名 。 

口 spring.jackson.deserialization 

影响 Java 对 象 反 序列 化 的 Jackson on/off 特 性 。 

D spring.jackson.generator 

用 于 生成 器 的 Jackson on/off 特 性 。 

口 spring.jackson.joda-date-time-format 
Joda 日 期 时 间 格 式 字 符 串 (yyyy-MM-dd HH:mm:ss )。 如 果 没 有 配置 ， 而 aate-format 
又 配置 了 一 个 格式 字符 串 的 话 ， 会 将 它 作为 降级 配置 。 

D spring.jackson.locale 

用 于 格式 化 的 地 域 值 。 

口 spring.jackson.mapper 

Jackson 的 通用 on/off 特 性 。 

口 spring.jackson.parser 


用 于 解析 器 的 Jackson on/off 特 性 。 


口 spring.jackson.property-naming-strategy 





























三 




















T 



























































Jackson 的 PropertyNamingStrategy 中 的 一 个 常量 ( CAMEL CASE TO LOWER CASI 
WITH_UNDERSCORES )。 也 可 以 设置 PropertyNamingStrategy 的 子 类 的 全 限定 类 名 。 
口 spring.jackson.serialization 
影响 Java 对 象 序列 化 的 Jackson on/off 特 性 。 
D spring.jackson.serialization-inclusion 
控制 序列 化 时 要 包含 哪些 属性 。 可 选择 Jackson 的 JsonInclude.Include 枚 举 里 的 某 个 
值 。 














uj 
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spring.jackson.time-zone 
格式 化 日 期 时 使 用 的 时 区 。 可 以 配置 各 种 可 识别 的 时 区 标识 符 ， 比 如 America/Los_ 
Angeles 或 者 GMT+10。 














spring.jersey.filter.order 

Jersey 过 滤器 链 的 顺序 。( 默认 值 : 0。) 

spring.jersey.init 

通过 Servlet 或 过 滤器 传递 给 Jersey 的 初始 化 参数 。 

Spring.jersey.type 

Jersey 集 成 类 型 。 可 以 是 servlet 或 者 filter。 

spring.jms.jndi-name 

连接 工厂 的 JNDI 名 字 。 设 置 了 该 属性 ， 则 优先 于 其 他 自动 配置 的 连接 工厂 。 
Spring.jms.li 
容 需 的 应 答 模式 


























tener.acknowledge-mode 


acknowledgment mode )。 默 认 情 况 下 ， 监 听 器 使 用 自动 应 答 。 








S 
( 

Spring.j listener.auto-startup 

pum Ño (默认 值 : true, ) 

spring.jms.listener.concurrency 

并 发 消费 者 的 数量 下 限 。 

spring.j listener.max-concurrency 

p 

spring.jms.pub-sub-domain 

如 果 是 主题 而 非 队列 ， 指 明 默 认 的 目的 地 类 型 是 否 支 持 Pub/Sub。( 默认 值 : false.) 

Spring.jmx.default-domain 

JMX 域 名 。 

spring.jmx.enabled 

将 管理 Bean 发 布 到 JMX 域 里 。( 默认 值 : true。) 

spring.jmx.server 


MBeanServer 的 Bean 名 称 。( 默认 值 : mbeanServer。) 
































Spring.jooq.sql-dialect 

在 与 配置 的 数据 源 通信 时 ，JOOQ 使 用 的 soLDialect， 比 如 PoSsTGRES。 
Spring.jpa.database 

要 操作 的 目标 数据 库 ， 默 认 自 动 检测 。 也 可 以 通过 databasePlatform 属 性 进行 设置 。 
spring.jpa.database-platform 
要 操作 的 目标 数据 库 ， 默 认 自动 检测 。 也 可 以 通过 Database 枚 举 来 设置 。 
spring.jpa.generate-ddl 


启动 时 要 初始 化 Schema。( EG: false.) 


spring.jpa.hibernate.ddl-auto 
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DDL 模 式 (none, validate, update, createffllereate-drop). XXJÉhibernate. 
hbm2ddl. auto 属 性 的 一 个 快捷 方式 。 在 使 用 能 人 式 数 据 库 时 , 默认 为 c reate-drop; 
其 他 情况 下 默认 为 none。 
口 spring.jpa.hibernate.naming-strategy 
Hibernate 命 名 策略 的 全 限定 类 名 。 
D spring.jpa.open-in-view 
iH openEntityManagerInViewInterceptor, 在 请 求 的 整个 处 理 过 程 中 , 将 一 个 JPA 
EntityManager 绑 定 到 线程 上 。( 默认 值 : true。 ) 
口 spring.jpa.properties 
JPA 提 供 方 要 设置 的 额外 原生 属性 。 
LI spring.jpa.show-sql 
在 使 用 Bitronix Transaction Manager 时 打开 SQL 语句 日 志 。( 默认 值 : false。) 
口 spring.jta.allow-multiple-lrc 
在 使 用 Bitronix Transaction Manager 时 ， 事 务 管理 器 是 否 应 该 允许 一 个 事务 涉及 多 个 LRC 
资源 。( 默认 值 : false.) 
口 spring.jta.asynchronous2-pc 
在 使 用 Bitronix Transaction Manager 时 ， 是 否 异 步 执行 两 阶段 提交 。( 默认 值 : false.) 
口 spring.jta.background-recovery-interval 
在 使 用 Bitronix Transaction Manager 时 ， 多 久 运 行 一 次 恢复 过 程 ， 单 位 为 分 钟 。( 默认 值 : 
123) 
DD spring.jta.background-recovery-interval-seconds 
在 使 用 Bitronix Transaction Manager 时 ,多久 运行 一 次 恢复 过 程 ,单位 为 秒 。( 默认 值 :650。 ) 
口 spring.jta.current-node-only-recovery 
在 使 用 Bitronix Transaction Manager 时 ， 恢 复 是 否 要 滤 除 不 包含 本 JVM 唯 一 了 D 的 XID。( 默 
认 值 : trueo ) 
口 spring.jta.debug-zero-resource-transaction 











在 使 用 Bitronix Transaction Manager 时 ， 对 于 没有 涉及 任何 资源 的 事务 ， 是 否 要 跟踪 并 记 
录 它 们 的 创建 和 提交 调用 栈 。( 默认 值 : false.) 





口 spring.jta.default-transaction-timeout 

















在 使 用 Bitronix Transaction Manager 时 ， 默 认 的 事务 超时 时 间 , 单位 为 秒 。( 默认 值 : 60。 ) 


D spring.jta.disable-jmx 


在 使 用 Bitronix Transaction Manager 时 ， 是 否 要 禁止 注册 JMX MBean。( 默认 值 : false。 ) 


口 spring.jta.enabled 





开启 JTA 支 持 。( 默认 值 ， true。 ) 














D spring.jta.exception-analyzer 





在 使 用 Bitronix Transaction Manager 时 用 到 的 异常 分 析 器 。 设 置 为 nu11 时 使 用 默认 异常 分 
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析 器 ， 也 可 以 设置 自 定 义 蜡 篆 分 析 需 的 全 限定 类 名 。 
Spring.jta.filter-log-status 

在 使 用 Bitronix Transaction Manager 时 ， 是 否 只 记录 必要 的 日 志 。 开 启 该 参数 时 能 减少 分 
Bt (fragment) 空间 用 量 ， 但 调试 更 复杂 了 。( 默认 值 : false.) 
spring.jta.force-batching-enabled 

在 使 用 Bitronix Transaction Manager 时 ， 是 否 批量 输出 至 磁盘 。 禁 用 批 处 理会 严重 降低 事 
务 管理 器 的 吞吐 量 。( 默认 值 : true.) 

spring.jta.forced-write-enabled 

在 使 用 Bitronix Transaction Manager 时 ， 日 志 是 否 强制 写 到 磁盘 上 。 在 生产 环境 里 不 要 设 
置 为 false， 因 为 不 强制 写 到 磁盘 上 无 法 保证 完整 性 。( 默认 值 : true.) 
Spring.jta.graceful-shutdown-interval 

在 使 用 Bitronix Transaction Manager 时 ， 要 关闭 的 话 ， 事 务 管理 器 在 放弃 事务 前 最 多 等 它 
多 少 秒 。( 默认 值 : 60.) 
spring.jta.jndi-transaction-synchronization-registry-name 

在 使 用 Bitronix Transaction Manager 时 ， 事 务 同 步 注册 表 应 该 绑 定 到 哪个 JNDIF 。( 默认 


值 : java:comp/TransactionSynchronizationRegistry,) 








pu 
































spring.jta.jndi-user-transaction-name 
在 使 用 Bitronix Transaction Manager 时 ， 用 户 事 务 应 该 绑 定 到 哪个 JNDI 下 o (RE: 


java:comp/UserTransaction,) 








Spring.jta.journal 

在 使 用 Bitronix Transaction Manager 时 ， 要 用 的 日 志 名 。 可 以 是 aisk、nul11 或 者 全 限定 类 
名 。( 默 认 值 : disk.) 
Spring.jta.log-dir 
事务 日 志 目 录 。 

Spring.jta.log-partl-filename 

日 志 分 段 文件 1 的 名 称 。( 默认 值 : ptm1 .tlog。 ) 

Spring.jta.log-part2-filename 

日 志 分 段 文件 2 的 名 称 。( 默认 值 : ptm2 .Elog。 ) 

spring.jta.max-log-size-in-mb 

在 使 用 Bitronix Transaction Manager 时 ， 日 志 分 段 文 件 的 最 大 兆 数 。 日 志 越 大 ， 事 务 就 被 
允许 在 未 终结 状态 停留 越 长 时 间 。 但 是 ， 如 果 文 件 大 小 限制 得 太 小 ， 事 务 管理 器 在 分 段 
满 了 的 时 候 就 会 暂停 更 长 时 间 。( 默认 值 : 2。 ) 
spring.jta.resource-configuration-filename 

Bitronix Transaction Manager 的 配置 文件 名 。 
Spring.jta.server-id 


唯一 标识 Bitronix Transaction Manager 实 例 的 ID。 
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口 spring.jta.skip-corrupted-logs 

是 否 跳 过 损坏 的 日 志文 件 。( 默认 值 : false.) 

D spring.jta.transaction-manager-id 

事务 管理 器 的 唯一 标识 符 。 

口 spring.jta.warn-about-zero-resource-transaction 
在 使 用 Bitronix Transaction Manager 时 ， 是 否 要 对 执行 时 没有 涉及 任何 资源 的 事务 作出 告 
E. (默认 值 : trueo ) 

CL] spring.mail.default-encoding 

默认 的 MimeMessage 编 码 。( 默认 值 : UTF-8.) 

口 spring.mail.host 

SMTP 服 务 需 主机 地 址 。 

D spring.mail.jndi-name 

会 话 的 JNDI 名 称 。 设 置 之 后 ， 该 属性 的 优先 级 要 高 于 其 他 邮件 设置 。 

口 spring.mail.password 

SMTP 服 务 需 的 登录 密码 。 

口 spring.mail.port 

SMTP 服 务 吉 的 端口 号 。 

口 spring.mail.properties 

附加 的 JavaMail 会 话 属性 。 

口 spring.mail.protocol 

SMTP 服 务 器 用 到 的 协议 。( 默认 值 : smtp.) 

口 spring.mail.test-connection 

在 启动 时 测试 邮件 服务 器 是 否 可 用 。( 默认 值 : false.) 

口 spring.mail.username 

SMTP 服 务 需 的 登录 用 户 名 。 

口 spring.messages.basenam 
过 号 分 隔 的 基本 名 称 列表 ， 都 遵循 ResourceBundle 的 惯例 。 本 质 上 这 就 是 一 个 全 限定 
的 Classpath 位 置 ， 如 果 不 包含 包 限 定 符 ( 比如 org .mypackage ), 就 会 从 Classpath 的 根部 
开始 解析 。( 默认 值 : messages。 ) 

口 spring.messages.cache-seconds 

加 载 的 资源 包 文件 的 缓存 失效 时 间 , 单位 为 秒 。 在 设置 为 -1 时 , 包 会 永远 缓存 。( 默认 值 : 

-1.) 






































































































































口 spring.messages.encoding 
消息 包 的 编码 。( 默认 值 : UTF-8。) 
口 spring.mobile.devicedelegatingviewresolver.enable-fallback 


开启 降级 解析 支持 。 ( 默认 值 : false.) 
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Spring.mobil 


Spring.mobil 


Spring.mobil 
添加 到 移动 设备 视图 名 后 的 后 级 。 
spring.mobil 


添加 到 普通 设备 视图 名 前 的 前 级 。 


spring.mobi 


spring.mobil 
添加 到 平板 设备 视图 名 前 的 前 级 。( 


spring.mobil 


j e.devicedelegatingviewresolver. 
开启 设备 视图 解析 器 。( 默认 值 : 
e.devicedelega 


添加 到 移动 设备 视图 名 前 的 前 级 。( 默 


添加 到 普通 设备 视图 名 后 的 后 绥 。 


nabled 





false.) 
ingviewresolver.mobile-prefix 


: mobile/,) 





S 
zm 


.devicedelegatingviewresolver.mobile-suffix 





devicedelegatingviewresolver.normal-prefix 


devicedelegatingviewresolver.normal-suffix 





.devicedelegatingviewresolver.tablet-prefix 
RYE: tablet/.) 


.devicedelegatingviewresolver.tablet-suffix 


um 
































添加 到 平板 设备 视图 名 后 的 后 绥 。 





spring.mobil 


.Sitepreferenc nabled 











开局 Sit PreferenceHandl ro 默认 值 : 





true, ) 





spring.mongodb.embedded.features 
TOJDuBEERnE, Ham. 
spring.mongodb.embedded.version 


要 使 用 的 Mongo 版 本 。( 默认 值 : 2.6.10.) 





spring.mustac 


开局 模板 缓存 。 


Spring.mustac 


模板 编码 。 


Spring.mustac 





he.cache 


he.charset 


he.check-template-location 




















检查 模板 位 置 是 否 存在 。 





Spring.mustac 


he. content-type 


Content-Type 的 值 。 


Spring.mustac 


he.enabled 


开启 Mustache 的 MVC 视 图 解析 。 


spring.mustac 
添加 到 模板 名 前 和 
spring.mustac 
添加 到 模板 名 后 上 


spring.mustac 




















he.prefix 
IRT o CRAB: 
he.suffix 
JER. 默认 值 : 


he.view-names 


classpath:/ templates/,) 





.html, ) 





可 解析 的 视图 名 称 的 白 名 单 。 
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口 spring.mvc.async.request-timeout 
异步 请 求 处 理 超 时 前 的 等 待 时 间 (单位 为 毫秒 )。 如 果 没 有 设置 该 属性 ， 则 使 用 底层 实现 
的 默认 超时 时 间 ， 比 如 ，Tomcat 上 使 用 Servlet 3 时 超时 时 间 为 10 秒 。 
口 spring.mvc.date-format 
要 使 用 的 日 期 格式 〈 比 如 aa/MM/yyyy )。 
D spring.mvc.favicon.enabled 
开启 favicon.ico 的 解析 。( 默认 值 : crue.) 
口 spring.mvc.ignore-default-model-on-redirect 
在 重 定向 的 场景 下 ， 是 否 要 忽略 “默认 ”模型 对 象 的 内 容 。( 默认 值 : true。 ) 
口 spring.mvc.locale 
要 使 用 的 地 域 配置 。 
ü spring.mvc.message-codes-resolver-format 
消息 代码 格式 (PREFIX ERROR CODE, POSTFIX ERROR CODE), 














一 





















































口 spring.mvc.view.prefix 

Spring MVC 视 图 前 级 。 

L] spring.mvc.view.suffix 

Spring MVC 视 图 后 级 。 

口 spring.rabbitmq.addresses 

客户 端 应 该 连接 的 地 址 列表 ， 用 逗号 分 隔 。 

D spring.rabbitmq.dynamic 

创建 一 个 mqpAgdmin Bean。( 默认 值 : true.) 

LU spring.rabbitmq.host 

RabbitMQ 主 机 地 址 。( 默认 值 : localhost.) 

口 spring.rabbitmq.listener.acknowledge-mode 
Es BU WAREN o 
D spring.rabbitmq.listener.auto-startup 
启动 时 自动 开启 容器 。( 默认 值 : crues) 

ü spring.rabbitmq.listener.concurrency 
消费 者 的 数量 下 限 。 
D spring.rabbitmq.listener.max-concurrency 
消费 者 的 数量 上 限 。 
D spring.rabbitmq.listener.prefetch 

单个 请 求 里 要 处 理 的 消息 数 。 该 数值 不 应 小 于 事务 数 ( 如 果 用 到 的 话 )。 

ü spring.rabbitmq.listener.transaction-size 

一 个 事务 里 要 处 理 的 消息 数 。 为 了 保证 效果 ， 应 该 不 大 于 预先 获取 的 数量 。 


口 spring.rabbitmq.password 
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MBA 


进行 的 密码 。 


t 


身份 验证 
Spri 
RabbitMQ 端 口 。 


ing.rabbi 


ng.rabbitmq.port 


默认 值 : 5672.) 


tmq.requested-heartb 





at 





心跳 超时 ， 
ing.rabbi 
SSL 文 持 。( 
spring.rabbit 
持 有 SSL 证 书 的 KeyStore 路 径 。 
Spring.rabbit 
访问 KeyStore 的 密码 。 
Spring.rabbit 

持 有 SSL 证 书 的 TrustStore。 
spri E 
访问 TrustStore 的 密码 。 
Spring.rabbitmq.username 
进行 身份 验证 的 用 户 名 。 

spri t 
在 连接 RabbitMQ 
Spr 


单位 为 秒 ; 


tmq.ssl.enabled 


默认 值 : false.) 


q.ssl.key-store 





o 





q.ssl.trust-store 





ng.rabbi 





q.virtual-host 
时 的 虚拟 主机 。 


ing.redis.database 


ng.rabbi 











连接 工厂 使 用 的 数据 库 索 引 。( 默认 值 : 0。 





spri 
Redi 
Spring.redis.password 
Redis 服 务 需 的 登录 密码 。 

Spring.redis.pool. 
连接 


spri 


ng.redis.host 


S 


S 


ax-active 


max-idle 


0 表示 不 启用 心跳 。 


q.ssl.key-store-password 


q.ssl.trust-store-password 


) 


服务 器 主机 地 址 。( 默认 值 : localhost.) 








ng.redis.pool. 
连接 池 里 的 最 大 空闲 连接 数 。 负 数 表 示 空 


spring.redis.pool.max-wait 











s 闲 连接 数 可 以 是 无 限 大 。 


























当 连 接 池 被 耗 尽 时 ,分 配 连接 的 请 求 应 
数 表 示 一 直 阻塞 。( 默认 值 : -1。 ) 


spring.redis.pool. 























min-idle 


该 在 抛 出 异常 育 

















连接 池 里 要 维持 的 最 小 空间 连接 数 。 该 属 怕 


spring.redis.port 


Redis 服 务 器 端口 。( 默认 值 : 6379。 ) 











E 只 有 在 设置 为 正 数 时 才 有 效 。( 





(默认 值 : 


也 在 指定 时 间 里 能 分 配 的 最 大 连接 数 。 负 数 表 示 无 限制 。( 默认 值 : 8.) 


8。) 


1 被 阻塞 多 长 时 间 〈 单 位 为 秒 )。 fi 


RE: 0.) 
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口 


口 








spring.redis.sentinel.master 

RedisJlt 4 ARAF o 

Spring.redis.sentinel.nodes 

形 如 “主机 :端口 ”配对 的 列表 ， 用 逗号 分 隔 。 
spring.redis.timeout 

连接 超时 时 间 ， 单 位 为 秒 。( 默认 值 : 0.) 
Spring.resources.add-mappings 

开启 默认 资源 处 理 。( 默认 值 : trueo ) 
spring.resources.cache-period 

资源 处 理 器 对 资源 的 缓存 周期 ， 单 位 为 秒 。 
Spring.resources.chain.cache 

对 资源 链 开启 缓存 。( 默认 值 : true.) 
spring.resources.chain.enabled 

开启 Spring 资 源 处 理 链 。( 默认 关闭 的 ， 除 非 至 少 开 启 了 一 个 策略 。) 
Sspring.resources.chain.html-application-cache 

开启 HTML5 应 用 程序 缓存 证 明 重 写 。( 默认 值 : false.) 
spring.resources.chain.strategy.content.enabled 
开启 内 容 版 本 策略 。( 默认 值 : false.) 
Spring.resources.chain.strategy.content.paths 

要 运用 于 版 本 策略 的 模式 列表 ， 用 逗号 分 隔 。( 默认 值 : D/**1.) 
spring.resources.chain.strategy.fixed.enabled 

开启 固定 版 本 策略 。( 默认 值 : false.) 
spring.resources.chain.strategy.fixed.paths 

要 运用 于 固定 版 本 策略 的 模式 列表 ， 用 逗号 分 隔 。 
spring.resources.chain.strategy.fixed.version 

用 于 固定 版 本 策略 的 版 本 字符 串 。 
spring.resources.static-locations 

静态 资源 位 置 。 默认 为 classpath: [/META-INF/resources/, /resources/, /static/, 
/public/] 加 上 context:/ (Servlet 上 下 文 的 根 目录 )。 

spring.sendgrid.password 

SendGrid 密 码 。 
spring.sendgrid.proxy.host 
SendGrid 代 理 主 机 地 址 。 
Spring.sendgrid.proxy.port 
SendGrid 代 理 端口 。 


spring.sendgrid.username 
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SendGrid 用 户 名 。 
spring.social.auto-connection-views 
针对 所 支持 的 提供 方 开启 连接 状态 视图 。( 默认 值 : false.) 
Spring.social.facebook.app-id 

应 用 程序 ID。 
spring.social.facebook.app-secret 
应 用 程序 的 密 钥 。 
Spring.social.linkedin.app-id 

应 用 程序 ID。 
Spring.social.linkedin.app-secret 
应 用 程序 的 密 钥 。 
Spring.social.twitter.app-id 

应 用 程序 ID。 
Spring.social.twitter.app-secret 


应 用 程序 的 密 钥 。 
spring.thymeleaf.cache 

开启 模板 缓存 。 (默认 值 : true.) 
spring.thymeleaf.check-template-location 

检查 模板 位 置 是 否 存在 。( 默认 值 : true.) 

spring.thymeleaf.content-type 

content-Type 的 值 。 (默认 值 : text/htmlo ) 

spring.thymeleaf.enabled 

开启 MVC Thymeleaf 视 图 解析 。( 默认 值 : true.) 

spring.thymeleaf.encoding 

模板 编码 。( 默认 值 : urF-8.) 

spring.thymeleaf.excluded-view-names 

要 被 排除 在 解析 之 外 的 视图 名 称 列表 ， 用 逗号 分 隔 。 

spring.thymeleaf.mode 

要 运用 于 模板 之 上 的 模板 模式 。 另 见 sStandardqTemplate- ModeHandlers。( 默认 值 : 


HTML5。) 
























































Sspring.thymeleaf.prefix 

在 构建 URL 时 添加 到 视图 名 称 前 的 前 级 。( 默认 值 : classpath:/templates/.) 
spring.thymeleaf.suffix 

在 构建 URL 时 添加 到 视图 名 称 后 的 后 级 。( 默认 值 : .html。 ) 
spring.thymeleaf.template-resolver-order 


Thymeleaf 异 板 解析 器 在 解析 咒 链 中 的 顺序 。 默 认 情 况 下 ， 它 排 在 第 一 位 。 顺 序 从 1 开始 ， 
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只 有 在 定义 了 额外 的 TemplateResolver Bean 时 才 需 要 设置 这 个 属性 。 
D spring.thymeleaf.view-names 
可 解析 的 视图 名 称 列表 ， 用 逗号 分 隔 。 
口 spring.velocity.allow-request-overrid 
HttpServletRequest 的 属性 是 否 允许 覆盖 ( 隐藏 ) 控制 器 生成 的 同名 模型 属性 。 
ü spring.velocity.allow-session-override 














HttpSession 的 属性 是 否 允 许 覆 盖 ( 隐藏 ) 控制 器 生成 的 同名 模型 属性 。 
spring.velocity.cache 

开启 模板 缓存 。 
spring.velocity.charset 
模板 编码 。 
spring.velocity.check-template-location 
检查 模板 位 置 是 否 存在 。 
Spring.velocity.content-type 
Content-Type 的 值 。 

















spring.velocity.date-tool-attribute 

DateTool 辅 助 对 象 在 视图 的 Velocity 上 下 文 里 呈现 的 名 字 。 
Sspring.velocity.enabled 

开启 Velocity 的 MVC 视 图 解析 。 

spring.velocity.expose-request-attributes 

在 模型 合并 到 模板 前 ， 是 否 要 把 所 有 的 请 求 属性 添加 到 模型 里 。 
spring.velocity.expose-session-attributes 

在 模型 合并 到 模板 前 ， 是 否 要 把 所 有 的 Httpsession 属 性 添加 到 模型 里 。 
spring.velocity.expose-spring-macro-helpers 

是 否 发 布 供 Spring 宏 程序 库 使 用 的 Requestcontext ， 并 将 其 名 命 为 springMacro- 


RequestContextso 










































































spring.velocity.number-tool-attribute 


NumberTool 辅 助 对 象 在 视图 的 Velocity 上 下 文 里 呈现 的 名 字 。 





spring.velocity.prefer-file-system-access 

加 载 模板 时 优先 通过 文件 系统 访问 。 文 件 系统 访问 能 够 实时 检测 到 模板 变更 。( 默认 值 : 
true,) 

spring.velocity.prefix 


TETAIEEUR LISEZ JT LAST APA RE ET RUE SR o 
Sspring.velocity.properties 
额外 的 Velocity 属性 。 


spring.velocity.request-context-attribute 
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所 有 视图 里 使 用 的 Request- Context 属 性 的 名 称 。 
spring.velocity.resource-loader-path 

模板 路 径 。( 默认 值 : classpath:/ templates/.) 
Spring.velocity.suffix 

在 构建 URL 时 添加 到 视图 名 称 后 的 后 级 。 
spring.velocity.toolbox-config-location 
Velocity Toolbox 的 配置 位 置 ， 比 如 /WEB-INF/toolbox.xml。 
义 文件 ， 将 所 定义 的 全 部 工具 发 布 到 指定 的 作用 域内 。 
spring.velocity.view-names 

可 解析 的 视图 名 称 白 名 单 。 

spring.view.prefix 

Spring MVC 视 图 前 级 。 

spring.view.suffix 


Spring MVC 视 图 后 级 。 





























自动 加 载 Velocity Tools 工 具 定 
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无 论 在 构建 项 目 时 使 用 的 是 Maven 、Gradle 还 是 Spring Boot CLI, Spring Boot 都 为 Spring 应 
用 程序 常用 的 很 多 库 提 供 了 依赖 管理 支持 功能 。 表 D-1 列 出 了 Spring Boot 1.3.0 版 本 支持 的 所 有 
库 依 赖 。 

在 很 多 情况 下 ， 这 些 依赖 都 会 通过 某 个 Spring Boot 起 步 依赖 自动 添加 到 项 目 和 Classpath 里 
(如 附录 A 所 述 )。 但 是 ， 如 果 你 正在 使 用 的 起 步 依赖 没有 覆盖 到 某 个 库 ， 而 你 需要 使 用 这 个 库 ， 
那 就 得 在 Maven 或 Gradle 的 构建 说 明 里 显 式 地 声明 这 个 依赖 。 

举例 来 说 ， 如 果 你 的 项 目 需要 引入 H2 悉 入 式 数 据 库 ， 那 么 你 需要 在 Gradle 里 加 入 如 下 声明 : 


compile("com.h2database:h2") 
在 Maven 里 可 以 添加 类 似 的 声明 : 


«dependency» 
«groupId»com.h2database«/groupId» 
«version»h2«/version» 

</dependency> 


请 注意 ,在 这 两 种 情况 下 ， 都 不 需要 指定 版 本 号 ，Spring Boot 的 依赖 管理 会 奉 你 处 理 这 个 问 
题 的 。 但 是 ， 如 果 想 覆盖 Spring Boot 选 择 的 版 本 ， 你 也 可 以 显 式 地 提供 一 个 版 本 号 。 
如 果 在 使 用 Spring Boot CLI 运 行 应 用 程序 ， 你 可 以 在 Groovy 里 像 这 样 使 用 eGrab 注 解 : 


GGrab("h2") 


在 使 用 ecrab 注 解 引入 表 D-1 里 的 库 时 ， 你 只 需要 指定 Artifact IDE HI LA f o Spring Boot 扩 展 
了 eGrab， 让 它 可 以 推测 出 Group ID 和 版 本 号 。 
























































表 D-1 Spring Boot 1.3.0 所 支持 的 库 依赖 





Group ID Artifact ID 版 本 号 
antlr antlr 2/73 
ch.qos.logback logback-access 1.1.3 
ch.qos.logback logback-classic 1.1.3 
com.atomikos transactions-jdbc 3.9.3 


com.atomikos transactions-jms 3.9.3 
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Group ID Artifact ID 版 本 号 
com.atomikos transactions-jta 3.9.3 
com.fasterxml.jackson.core jackson-annotations 2.6.3 
com.fasterxml.jackson.core jackson-core 2.6.3 
com.fasterxml.jackson.core jackson-databind 2.6.3 
com.fasterxml.jackson.datafo jackson-dataformat-csv 2.6.3 
rmat 
com.fasterxml.jackson.datafo jackson-dataformat-xml 2.6.3 
rmat 
com.fasterxml.jackson.datafo jackson-dataformat-yaml 2.6.3 
rmat 
com.fasterxml.jackson.dataty jackson-datatype-hibernate4 2.6.3 
pe 
com.fasterxml.jackson.dataty jackson-datatype-hibernate5 2.63 
pe 
com.fasterxml.jackson.dataty jackson-datatype-jdk7 2.6.3 
pe 
com.fasterxml.jackson.dataty jackson-datatype-jdk8 2.6.3 
pe 
com.fasterxml.jackson.dataty jackson-datatype-joda 2.6.3 
pe 
com.fasterxml.jackson.dataty jackson-datatype-jsr310 2.6.3 
pe 
com.fasterxml.jackson.module . jackson-module-parameter-names 2.6.3 
com.gemstone.gemfire gemfire 8.1.0 
com.github.mxab.thymeleaf.ex thymeleaf-extras-data-attribute 1.3 
tras 
com.google.code.gson gson 23.1 
com.googlecode.json-simple json-simple 1.1.1 
com.h2database h2 1.4.190 
com.hazelcast hazelcast 3.5.3 
com.hazelcast hazelcast-spring 3.5.3 
com.jayway.jsonpath json-path 2.0.0 
com.jayway.jsonpath json-path-assert 2.0.0 
com.samskivert jmustache 1.11 
com.sendgrid sendgrid-java 2.2.2 
com.sun.mail javax.mail 1.5.4 
com.timgroup java-statsd-client 3.1.0 
com. zaxxer HikariCP 24. 
com.zaxxer HikariCP-java6 2.3.12 
commons-beanutils commons-beanutils 1.9.2 
commons-collections commons-collections 3.2.1 
commons-dbcp commons-dbcp 1.4 
commons-digester commons-digester 2.1 
commons-pool commons-pool 1.6 
de.flapdoodle.embed de.flapdoodle.embed.mongo 1.50.0 
io.dropwizard.metrics metrics-core 3.1.2 
io.dropwizard.metrics metrics-ganglia 3.1.2 
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Group ID Artifact ID 版 本 号 
io.dropwizard.metrics metrics-graphite 3.1.2 
io.dropwizard.metrics metrics-servlets 3.1.2 
io.projectreactor reactor-bus 2.0.7.RELEASE 
io.projectreactor reactor-core 2.0.7.RELEASE 
io.projectreactor reactor-groovy 2.0.7.RELEASE 
io.projectreactor reactor-groovy-extensions 2.0.7.RELEASE 
io.projectreactor reactor-logback 2.0.7.RELEASE 
io.projectreactor reactor-net 2.0.7.RELEASE 
io.projectreactor reactor-stream 2.0.7..RELEASE 
io.projectreactor.spring reactor-spring-context 2.0.6.RELEASE 
io.projectreactor.spring reactor-spring-core 2.0.6.RELEASE 
io.projectreactor.spring reactor-spring-messaging 2.0.6.RELEASE 
io.projectreactor.spring reactor-spring-webmvc 2.0.6.RELEASE 
io.undertow undertow-core 1.3.5.Final 
io.undertow undertow-servlet 1.3.5.Final 
io.undertow undertow-websockets-jsr 1.3.5.Final 
javax.cache cache-api 1.0.0 
javax.jms jms-api 1.1-rev-1 
javax.mail javax.mail-api 1.5.4 
javax.servlet javax.servlet-api 3.1.0 
javax.servlet jstl 1.2 
javax.transaction javax.transaction-api 12 
jaxen jaxen 1.1.6 
joda-time joda-time 2.8.2 
junit junit 4.12 
10g4j log4j 1.2.17 
mysql mysql-connector-java 5.1.37 
net.sf.ehcache ehcache 2.10.1 
net.sourceforge.nekohtml nekohtml 1.9.22 
nz.net.ultraq.thymeleaf thymeleaf-layout-dialect 1.3.1 
org.apache.activemq activemq-amqgp 5.12.1 
org.apache.activemq activemq-blueprint 5.12.1 
org.apache.activemq activemq-broker 5.12.1 
org.apache.activemq activemq-camel 5.12.1 
org.apache.activemqg activemq-client 5.12.1 
org.apache.activemq activemq-console 5.12.1 
org.apache.activemq activemq-http 5.12.1 
org.apache.activemqg activemq-jaas 5.12.1 
org.apache.activemq activemq-jdbc-store 5.12.1 
org.apache.activemq activemq-jms-pool 5.12.1 
org.apache.activemq activemq-kahadb-store 5.12.1 
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Group ID Artifact ID 版 本 号 
org.apache.activemq activemq-karaf ASIA 
org.apache.activemq activemq-leveldb-store 5.12.1 
org.apache.activemq activemq-10g4j-appender 5.12.1 
org.apache.activemq activemq-mqtt 5.12.1 
org.apache.activemq activemq-openwire-generator 5.12.1 
org.apache.activemq activemq-openwire-legacy 5.12.1 
org.apache.activemq activemq-osgi 5.12.1 
org.apache.activemq activemq-partition 5.12.1 
org.apache.activemq activemq-pool 5.12.1 
org.apache.activemq activemq-ra 5.12.1 
org.apache.activemq activemq-run 5.12.1 
org.apache.activemq activemq-runtime-config 5.12.1 
org.apache.activemq activemq-shiro 5.12.1 
org.apache.activemq activemq-spring 5.12.1 
org.apache.activemq activemq-stomp 5.12.1 
org.apache.activemq activemq-web 5.12.1 
org.apache.activemq artemis-jms-client 1.1.0 
org.apache.activemq artemis-jms-server 1.1.0 
org.apache.commons commons -dbcp2 2.1.1 
org.apache.commons commons -poo1l2 24.2 
org.apache.derby derby 10.12.1.1 
org.apache.httpcomponents httpasyncclient 4.1.1 
org.apache.httpcomponents httpclient 4.5.1 
org.apache.httpcomponents httpcore 4.4.4 
org.apache.httpcomponents httpmime 4.5.1 
org.apache.logging.10g4j log4j-api 24.1 
org.apache.logging.10g4j log4j-core 24.1 
org.apache.logging.109g4j log4j-slf4j-impl 2.4.1 
org.apache.solr solr-solrj 4.10.4 
org.apache.tomcat.embed tomcat-embed-core 8.0.28 
org.apache.tomcat.embed tomcat-embed-el 8.0.28 
org.apache.tomcat.embed tomcat-embed-jasper 8.0.28 
org.apache.tomcat.embed tomcat-embed-logging-juli 8.0.28 
org.apache.tomcat.embed tomcat-embed-websocket 8.0.28 
org.apache.tomcat tomcat-jdbc 8.0.28 
org.apache.tomcat tomcat-jsp-api 8.0.28 
org.apache.velocity velocity 4 
org.apache.velocity velocity-tools 2.0 
org.aspectj aspectjrt 1.8.7 
org.aspectj aspectjtools 1.8.7 
org.aspectj aspectjweaver 1.8.7 
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Group ID Artifact ID 版 本 号 
org.codehaus.btm btm 2.1.4 
org.codehaus.groovy groovy 244 
org.codehaus.groovy groovy-all 2.4.4 
org.codehaus.groovy groovy-ant 2.4.4 
org.codehaus.groovy groovy-bsf 2.4.4 
org.codehaus.groovy groovy-console 244 
org.codehaus.groovy groovy-docgenerator 2.4.4 
org.codehaus.groovy groovy-groovydoc 2.4.4 
org.codehaus.groovy groovy-groovysh 2.4.4 
org.codehaus.groovy groovy-jmx 2.4.4 
org.codehaus.groovy groovy-json 2.4.4 
org.codehaus.groovy groovy-jsr223 2.444 
org.codehaus.groovy groovy-nio 2.4.4 
org.codehaus.groovy groovy-servlet 2.4.4 
org.codehaus.groovy groovy-sql 2.4.4 
org.codehaus.groovy groovy-swing 2.4.4 
org.codehaus.groovy groovy-templates 2.4.4 
org.codehaus.groovy groovy-test 2.4.4 
org.codehaus.groovy groovy-testng 2.4.4 
org.codehaus.groovy groovy-xml 2.4.4 
org.codehaus.janino janino 2.7.8 
org.crashub crash.cli 1.3.2 
org.crashub crash.connectors.ssh 1.3.[2 
org.crashub crash.connectors.telnet 1.3.2 
org.crashub crash.embed.spring 1.3.2 
org.crashub crash.plugins.cron 1.3.2. 
org.crashub crash.plugins.mail 13.2 
org.crashub crash.shell 1.3.2 
org.eclipse.jetty jetty-annotations 9.2.14.v20151106 
org.eclipse.jetty jetty-continuation 9.2.14.v20151106 
org.eclipse.jetty jetty-deploy 9.2.14.v20151106 
org.eclipse.jetty jetty-http 9.2.14.v20151106 
org.eclipse.jetty jetty-io 9.2.14.v20151106 
org.eclipse.jetty jetty-jsp 9.2.14.v20151106 
org.eclipse.jetty jetty-jmx 9.2.14.v20151106 
org.eclipse.jetty jetty-plus 9.2.14.v20151106 
org.eclipse.jetty jetty-security 9.2.14.v20151106 
org.eclipse.jetty jetty-server 9.2.14.v20151106 
org.eclipse.jetty jetty-servlet 9.2.14.v20151106 
org.eclipse.jetty jetty-servlets 9.2.14.v20151106 
org.eclipse.jetty jetty-util 9.2.14.v20151106 
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Group ID 


Artifact ID 


版 本 号 





org 


org 


org. 
org. 
org. 
org. 
org. 
org. 


.firebirdsql.jdbc 


org 
org 


org 


org. 


org. 


ers 


org. 


ers 


org. 
OE. 
org. 
org. 
org. 
org. 
org. 
org. 
org. 
org. 
org. 
org. 


org. 


org. 
org. 
org. 
org. 
org. 
og. 


org. 


org 


org 


org. 


org. 


org 


org. 


.eclipse.jetty 
.eclipse.jetty 


eclipse.jetty.orbit 
eclipse.jetty.websocket 
eclipse.jetty.websocket 
elasticsearch 
firebirdsql.jdbc 
firebirdsqal.jdbc 


.flywaydb 


.freemarker 


glassfish 


glassfish.jersey.contain 


glassfish.jersey.contain 


assfish.jersey.core 


assfish.jersey.ext 


assfish.jersey.ext 











Q Q Q Q 


assfish.jersey.media 
hamcrest 

hamcrest 

hibernate 

hibernate 

hibernate 

hibernate 

hibernate 


hibernate 


hibernate 


hornetq 
hornetq 


hsqldb 





infinispan 
infinispan 
javassist 


jdom 


.jolokia 


.json 


jooq 
jooq 


.jooqd 


liquibase 


jetty-webapp 
jetty-xml 
javax.servlet.jsp 
javax-websocket-server-impl 
websocket-server 
elasticsearch 
jaybird-jdk16 
jaybird-jdk17 
jaybird-jdk18 
flyway-core 
freemarker 
javax.el 


jersey-container-servlet 
jersey-container-servlet-core 


jersey-server 
jersey-bean-validation 
jersey-spring3 
jersey-media-json-jackson 
hamcrest-core 
hamcrest-library 
hibernate-core 
hibernate-ehcache 
hibernate-entitymanager 
hibernate-envers 
hibernate-jpamodelgen 


hibernate-validator 





essor 
hornetq-jms-client 


hornetq-jms-server 


hsqldb 





infinispan-jcache 
infinispan-spring4 
javassist 

jdom2 

jolokia-core 

json 

jooq 

jooq-meta 
jooq-codegen 


liquibase-core 


hibernate-validator-annotation-proc 


9.2.14.v20151106 
9.2.14.v20151106 
2.2.0.»201112011158 
9.2.14.v20151106 
9.2.14.v20151106 
1.5.2 

2.2.9 

2.2.9 

2:2:9 

3.2.1 

2.3.23 

3.0.0 

2.19 


1.3 

1.3 
4.3.11.Final 
4.3.11.Final 
4.3.11.Final 
4.3.11.Final 
4.3.11.Final 
5.2.2.Final 
5.2.2.Final 


2.4.7.Final 
2.4.7.Final 
2:3:9 
8.0.1.Final 
8.0.1.Final 
3.18.1-GA 
2.0.6 

1.3.[2 
20140107 
3.7.1 

3.7.1 

3.7.1 

3.4.1 
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Group ID Artifact ID 版 本 号 
org.mariadb.jdbc mariadb-java-client 1.23 
org.mockito mockito-core 1.10.19 
org.mongodb mongo-java-driver 2.13.3 
org.postgresql postgresql 9.4-1205-jdbc41 
org.skyscreamer jsonassert 1.2.3 
org.slf4j jcl-over-s1f4j 1.7.13 
org.s1f4j jul-to-s1f4j 1.7.13 
org.slf4j log4j-over-s1f4j 1.7.13 
org.s1f4j slf4j-api 1.7.13 
ordg.slt43 Slf4j-jdk14 1.7.13 
org.s1f4j S1f4j-109g4712 1.7.13 
org.s1f4j slf4j-simple 1.7.13 
org.spockframework Spock-core 1.0-groovy-2.4 
org.Spockframework Spock-spring 1.0-groovy-2.4 
org.springframework spring-core 4.2.3.RELEASE 
org.springframework Sspring-framework-bom 4.2.3.RELEASE 
org.springframework springloaded 1.2.4.RELEASE 
org.springframework.amqp Sspring-amqp 1.5.2.RELEASE 
org.springframework.amqp Spring-rabbit 1.5.2.RELEASE 
org.springframework.batch spring-batch-core 3.0.5.RELEASE 
org.springframework.batch spring-batch-infrastructure 3.0.5.RELEASE 
org.springframework.batch Spring-batch-integration 3.0.5.RELEASE 
org.springframework.batch spring-batch-test 3.0.5.RELEASE 
org.springframework.cloud spring-cloud-cloudfoundry-connector ]1.2.0.RELEASE 
org.springframework.cloud spring-cloud-core ]1.2.0.RELEASE 
org.springframework.cloud spring-cloud-heroku-connector ]1.2.0.RELEASE 
org.springframework.cloud spring-cloud-localconfig-connector ]1.2.0.RELEASE 
org.springframework.cloud spring-cloud-spring-service-connector 1.2.0.RELEASE 
org.springframework.data Spring-data-releasetrain Gosling-SRIRELEASE 
org.springframework.hateoas Sspring-hateoas 0.19.0.RELEASE 
org.springframework.integrat Spring-integration-bom 4.2.].RELEASE 
ion 
org.springframework.integrat Spring-integration-http 4.2.].RELEASE 
ion 
org.springframework.mobile Spring-mobile-device 1.1.5.RELEASE 
org.springframework.plugin spring-plugin-core ]1.2.0.RELEASE 
org.springframework.retry spring-retry 1.1.2.RELEASE 
org.springframework.security Spring-security-bom 4.0.3.RELEASE 
org.springframework.security Sspring-security-jwt 1.0.3.RELEASE 
org.springframework.security Spring-security-oauth 2.0.8.RELEASE 
.oauth 
org.springframework.security Spring-security-oauth2 2.0.8.RELEASE 


.oauth 
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(4) 
Group ID Artifact ID 版 本 号 

org.springframework.session Spring-session 1.0.2.RELEASE 
org.springframework.session Spring-session-data-redis 1.0.2.RELEASE 
org.springframework.socia spring-social-config 1.1.3.RELEASE 
org.springframework.socia spring-social-core 1.1.3.RELEASE 
org.springframework.socia Sspring-social-security 1.1.3.RELEASE 
org.springframework.socia Sspring-social-web ].1.3.RELEASE 
org.springframework.socia Sspring-social-facebook 2.0.2.RELEASE 
org.springframework.socia spring-social-facebook-web 2.0.2.RELEASE 
org.springframework.social spring-social-linkedin 1.0.2.RELEASE 
org.springframework.socia spring-social-twitter ].1.2.RELEASE 
org.springframework.ws Sspring-ws-core 2.2.3. RELEASE 
org.springframework.ws spring-ws-security 2.2.3. RELEASE 
org.springframework.ws spring-ws-support 2.2.3. RELEASE 
org.springframework.ws spring-ws-test 2.2.3.RELEASE 
org.thymeleaf thymeleaf 2.1.4. RELEASE 
org.thymeleaf thymeleaf-spring4 2.1.4. RELEASE 
org.thymeleaf.extras thymeleaf-extras-conditionalcomments 2.]1.1.RELEASE 
org.thymeleaf.extras thymeleaf-extras-springsecurity4 2.1.2.RELEASE 
org.webjars hal-browser 9f96c74 
org.yaml snakeyaml 1.16 
redis.clients jedis 2.7.3 

wsdl4j wsdl4j 1.6.3 
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本 书 对 Java7 和 Java 8 中 影响 性 能 的 因素 展开 了 全 面 深入 的 介绍 ， 讲 解 传统 上 影响 应 用 性 
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能 的 JVM 特 征 ， 包 括 即 时 编译 器 、 垃 圾 收集 、 语 言 特征 等 。 内 容 包括 : 用 G1 垃圾 收集 器 最 
大 化 应 用 的 吞吐 量 ; 使 用 Java 飞 行 记录 器 查看 性 能 细节 ， 而 不 必 借 助 专 业 的 分 析 工 具 ; € 
内 存 与 原生 内 存 最 佳 实践 ; 线程 与 同步 的 性 能 ， 以 及 数据 库 性 能 最 佳 实践 等 。 
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本 书 由 曾 任 职 于 Oracle/Sun 的 性 能 优化 专家 编写 ， 系 统 而 详细 地 讲解 了 性 能 优化 的 各 个 方 
Java 性 能 优化 至 经 ! Java 之 父 重 磅 推荐 ! 面 ， 帮 助 你 学 习 Java 虚 拟 机 的 基本 原理 、 掌 握 一 些 监控 Java 程 序 性 能 的 ， 从 而 快速 找 
java 性 能 优化 到 程序 中 的 性 能 瓶颈 ， 并 有 效 改善 程序 的 运行 性 能 。 
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本 书 结构 清晰 、 内 容 翔 实 ， 从 实例 入 手 ， 涵 盖 Java 8 的 主要 新 特性 ， 包 括 Lambda 表 达 式 、 
M 方法 引用 、 流 、 默 认 方 法 、Optional、CompletableFuture 以 及 新 的 日 期 和 时 间 API， 是 程 
序 员 了 解 Java 8 新 特性 的 终极 指南 。 
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本 书 旨 在 帮助 有 经 验 的 Java 程 序 员 充 分 使 用 Java7 和 Java 8 的 功能 ， 但 也 可 供 Java 开 发 新 
手 学 习 。 书 中 提供 了 大 量 示例 ， 演 示 了 如 何 充分 利用 现代 API 和 开发 过 程 中 的 最 佳 实践 。 这 
一 版 进行 了 全 面 更 新 。 第 一 部 分 快速 准确 地 介绍 了 Java 编 程 语言 和 Java 平 台 。 第 二 部 分 讨 
论 了 核心 概念 和 API， 展 示 了 如 何在 Java 环 境 中 解决 实际 的 编程 任务 。 
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Spring 改变 了 企业 级 Java 应 用 开发 方式 ， 让 
Java 开 发 更 简单 、 高 效 ; Sping Boot 则 在 这 个 基 
础 上 ， 让 开发 者 的 生活 更 上 一 个 台阶 ! 


本 书 是 Spring Boot 的 终极 指南 ， 以 自动 配 
置 、 起 步 依赖 、 命 令 行 界面 和 Actuator 这 四 个 核 
心 特性 为 基础 ， 深 入 介绍 Spring Boot 的 用 法 ， 
让 所 有 Java 开 发 者 不 费 吹 灰 之 力 就 能 构建 出 满 
足 生产 需求 的 服务 ， 真 正 享受 技术 达 人 的 乐趣 | 
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显 式 配置 构建 完整 的 Spring 应 用 程序 


令 了 解 如 何 为 Spring Boot 应 用 程序 编写 自动 
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令 开 发 Spring Boot CLI 应 用 程序 


倒 探 秘 Actuator 的 Web 端 点 、 远 程 shell 和 
JMX MBean 


令 自 如 部 署 各 种 Spring Boot 应 用 程序 


|i MANNING 


图 灵 社 区 : iTuring.cn 
热线 : (010)51095186 转 600 


分 类 建议 “计算 机 /程序 设计 /Java 





人 民 邮 电 出 版 社 网 址 : www.ptpress.com.cn 


“Craig Walls 的 著作 正 是 Spring 的 完美 缩影 。 
Spring it I JLF MRA, ARAARA, IRE 
者 学 习 负 担 持续 减轻 ， 不 再 需要 掌握 那么 多 知识 就 
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